Update README.md

Author: RobThePCGuy

README.md

@@ -2,76 +2,89 @@
 
 ![GUI Screenshot](https://github.com/user-attachments/assets/10f965eb-e1cc-4d61-9b6f-0cbb484a4ef0)
 
-> [!IMPORTANT]
-> This is an unofficial modification for the BlueStacks Android emulator. If you encounter any issues, please open a GitHub issue.
+This tool allows you to toggle root access and enable read/write (R/W) permissions for your BlueStacks instances. It automatically detects both master and cloned instances, eliminating the need to manually edit configuration files as described in my original guide: **[Root BlueStacks with Kitsune Mask](https://github.com/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask/)**.
+
+## ✨ Features
+
+- **Auto-detection:** Quickly identifies BlueStacks instances from the Windows Registry.
+- **Root Toggle:** Enables or disables root access **(`Root: On/Off`)** in `bluestacks.conf`.
+- **Read/Write Permissions:** Easily sets filesystem permissions **(`R/W: On/Off`)** per instance.
+- **Dynamic Status Updates:** Real-time GUI updates reflect current root and R/W states.
+
+## 📥 Installation
+
+1. **Download** the latest executable (`.exe`) from the **[Releases](https://github.com/RobThePCGuy/BlueStacks-Root-GUI/releases)** page.
+2. **Run** the downloaded `.exe` file (portable—no formal installation needed).
+3. **Prerequisites:**
+   **Fully Uninstall BlueStacks:**
+      - Use the official tool to completely **[uninstall all previous BlueStacks installations](https://support.bluestacks.com/hc/en-us/articles/360057724751-How-to-uninstall-BlueStacks-5-BlueStacks-X-and-BlueStacks-Services-completely-from-your-PC)**.
+      - Download the latest BlueStacks version from the official website: **[BlueStacks](https://www.bluestacks.com/)**.
+
+## 🎯 Usage
+
+1. Launch the downloaded `.exe` file.
+2. The GUI auto-detects and lists all available BlueStacks instances.
+3. Select the instances you wish to modify.
+4. Use provided toggles:
+   - **Toggle Root** – Switch this **ON** only until you have installed Kitsune to **`/system`**.
+   - **Toggle R/W** – This must be **ON** for the instance to remain rooted.
+5. Download the **[Kitsune Mask](https://github.com/1q23lyc45/KitsuneMagisk/releases)** apk file.
+6. Launch the instance from the Multi-Instance Manager and install the apk.
+7. You should see the Kitsune Mask application; click on it to run.
+8. Root using **Kitsune Mask**:
+   - Once open, look to the top under the Kitsune Mask section and select the **Install** option.
+   - At the top right, tap the **Next** link to proceed.
+   - Select the **Direct Install to /system** option.
+
+>[!NOTE]
+> If the **Direct Install to /system** option is missing, do not select **Direct Install**.
 >
-> *As of February 16th, 2025, this tool works as expected. However, it's important to note that this method is not compatible with Nougat instances. This README will be updated if that changes.*
+> Completely close and reopen the Kitsune Mask app. This usually resolves the issue.
 
-This GUI streamlines the configuration process outlined in my guide to [rooting BlueStacks](https://github.com/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask/). While it simplifies certain steps, **both repositories** are still required for complete rooting because the linked repository contains the core rooting process. This tool lets you toggle root access and enable read/write permissions for the filesystem within the `bluestacks.conf` file of selected BlueStacks instances, providing a user-friendly alternative to manual editing.
+9. Click Next and watch the install log for any errors.
+10. Allow Kitsune Mask to finish installing, then close the BlueStacks emulator.
+11. Use the provided toggles:
+    - **Toggle Root** – Switch this **OFF** once the Kitsune Mask install has been completed.
+    - **Toggle R/W** – This must be **ON** for the instance to remain rooted.
+12. Close the BlueStacks-Root-Gui.
 
-## Features
+## ⚠️ Troubleshooting
 
-- Automatically detects BlueStacks instances via the Windows Registry and displays them for selection.
-- Toggles root access (`Root: On/Off`) in `bluestacks.conf` for selected instances.
-- Toggles read/write (`R/W: On/Off`) filesystem permissions for selected instances.
-- Dynamically updates the displayed root and R/W status in the GUI.
+### Common Issues:
+- **Configuration not found:**
+   **Fully Uninstall BlueStacks:**
+      - Use the official tool to completely **[uninstall all previous BlueStacks installations](https://support.bluestacks.com/hc/en-us/articles/360057724751-How-to-uninstall-BlueStacks-5-BlueStacks-X-and-BlueStacks-Services-completely-from-your-PC)**.
+      - Download the latest BlueStacks version from the official website: **[BlueStacks](https://www.bluestacks.com/)**.
+- **Permissions errors**: Run the GUI as an administrator.
 
-### Roadmap
-- Download the latest version of BlueStacks
-- Download the latest version of Magisk Delta
-- Integrate ADB-based rooting directly within the GUI.
+## 👩‍💻 Development
 
-## Installation
+### Getting Started:
+
+**Clone the repo:**
+```bash
+git clone https://github.com/RobThePCGuy/BlueStacks-Root-GUI.git
+cd BlueStacks-Root-GUI
+```
+
+**Install dependencies:**
+```bash
+pip install -r requirements.txt
+```
+
+**Run the application:**
+```bash
+python main.py
+```
+
+**Build executable:**
+```bash
+pyinstaller --onefile --windowed --icon=main.ico main.py
+```
+
+The built executable will be located in the `dist/` folder.
+
+## 🤝 Contributing
+
+Contributions are highly encouraged! Please open issues or submit pull requests to enhance this project.
 
-1. **Download:** Get the latest `.exe` release from the [Releases](https://github.com/RobThePCGuy/BlueStacks-Root-GUI/releases) page.
-2. **Run:** Double-click the downloaded `.exe` file. The application is portable and requires no formal installation.
-3. **Prerequisites:**
-   - BlueStacks must already be installed.
-   - Refer to my main rooting guide ([Root BlueStacks](https://github.com/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask/)) to complete the rooting process.
-
-## Usage
-
-1. Run the `.exe` file.
-2. The GUI will automatically detect and list available BlueStacks instances.
-3. Select the instance(s) you want to modify.
-4. Use the buttons:
-   - **Toggle Root:** Enables or disables root access.
-   - **Toggle R/W:** Enables or disables read/write permissions.
-5. The GUI displays the current `Root` and `R/W` status for each instance.
-6. After installing Kitsune Mask and completing the system partition installation steps described in the linked tutorial, you can **disable `Root` while leaving `R/W` enabled** if desired.
-7. Close the application when finished.
-
-## Troubleshooting
-
-**Common Issues:**
-
-- **"Configuration file not found":** Ensure that BlueStacks is installed. Confirm that the `bluestacks.conf` file exists in the correct directory (the GUI should handle this automatically). If the problem persists, open a GitHub issue.
-- **Status not updating:** Restart the application. Ensure BlueStacks is not running (it could be locking the `.bstk` files).
-- **Permissions error:** Run the application as an administrator.
-
-## Development
-
-**For Developers:**
-
-1. **Clone:**
-   ```bash
-   git clone https://github.com/RobThePCGuy/BlueStacks-Root-GUI.git
-   cd BlueStacks-Root-GUI
-   ```
-2. **Dependencies:**
-   ```bash
-   pip install -r requirements.txt
-   ```
-3. **Run:**
-   ```bash
-   python main.py
-   ```
-4. **Build (exe):**
-   ```bash
-   pyinstaller --onefile --windowed --icon=main.ico main.py
-   ```
-   The output file will be located inside the `dist/` folder.
-
-## Contributing
-
-Contributions are welcome! Please open an issue or submit a pull request.