Update README.md

Author: syntaxerror247

README.md

@@ -1,2 +1,56 @@
-# android-device-explorer
- A Godot Editor plugin for exploring and managing Android device file system
+# <img src="https://raw.githubusercontent.com/syntaxerror247/android-device-explorer/refs/heads/main/addons/android-device-explorer/device_explorer_icon.svg" width="24"> Android Device Explorer
+
+An editor plugin for **Godot** that lets you explore and manage the filesystem of connected ADB devices directly from within the editor.
+
+## Example Use Cases
+
+- Inspect logs or cached data generated by your app
+- Quickly push test files into your app's private data directory
+- Retrieve and debug files stored by your app
+- Upload, download, create, or delete files from device storage without leaving the editor
+
+## Getting Started
+
+### Prerequisites
+
+* Android device or emulator
+* ADB (Android Debug Bridge) installed
+* USB debugging enabled on your device
+* A debug build of your app installed on the device (Only Required to access app's private data)
+
+
+### Setup
+
+1. Download the latest release from the [GitHub Releases](https://github.com/syntaxerror247/android-device-explorer/releases)
+
+2. Extract and copy the plugin into your project's `addons` folder:
+   ```
+   [Project Root]/addons/android-device-explorer/
+   ```
+
+3. Open your project in Godot
+
+4. Enable the plugin:
+    - Go to `Project > Project Settings > Plugins`
+    - Enable **`Android Device Explorer`**
+
+5. Configure the plugin:
+    - **ADB Path**: Path to the `adb` executable on your system
+    - **Package Name**: Your app's debug package name (example, `org.godotengine.editor.v4.debug`)
+    <img width="450" height="275" alt="Config Window" src="https://github.com/user-attachments/assets/fd5260d9-6b3e-437d-ba3c-4c94e79858ce" />
+
+
+6. Connect your device:
+    - Connect your device and ensure USB debugging is enabled
+    - Or, start your Android emulator
+
+## Usage
+
+- Open the Device Explorer dock in the editor
+- Click the **Reload** button to detect connected devices
+- Browse your device's filesystem
+- Upload, download, create, or delete files as needed
+
+<img width="368" height="652" alt="Device Explorer" src="https://github.com/user-attachments/assets/53fbc0c4-17f8-4928-bf7e-8df2d1e6e0f5" />
+
+