first

Author: RobThePCGuy

README.md

@@ -0,0 +1,93 @@
+# BlueStacks Root GUI
+
+This is an AIO application designed to simplify the configuration part of my original tutorial on how to [root BlueStacks](https://github.com/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask/) with Kitsune Mask. If you want to do things manually, then the original repo is where you go. This tool will allow you to toggle root access and read/write (R/W) modes for BlueStacks instances. It provides an intuitive interface for managing these settings without manually editing configuration files.
+
+## Features
+
+- Reads Windows Registry to auto-detect the right directories and lists them individually for you to pick.
+- Toggles root access (`Root: On/Off`) for individual instances.
+- Toggles file system read/write access (`R/W: On/Off`) for individual instances.
+- Updates the current status of root and R/W modes dynamically in the GUI.
+
+## Installation
+
+1. **Download the Executable**:
+   - Download the latest `.exe` file from the [Releases](https://github.com/RobThePCGuy/BlueStacks-Root-GUI/releases) section.
+
+2. **Run the App**:
+   - Double-click the `.exe` file to open the GUI.
+   - No installation is required.
+
+3. **Requirements**:
+   - Ensure BlueStacks is installed on your system.
+   - The app detects BlueStacks configuration and instance files automatically.
+
+---
+
+## Usage Instructions
+
+1. Open the app by running the `.exe` file.
+2. The app will automatically detect available BlueStacks instances and display them in the GUI.
+3. Select an instance by checking its corresponding checkbox.
+4. Use the following buttons:
+   - **Toggle Root**: Toggles root access (`On`/`Off`) for the selected instance.
+   - **Toggle R/W**: Toggles read/write mode (`On`/`Off`) for the selected instance.
+5. Observe the status updates (`Root: On/Off` and `R/W: On/Off`) next to each instance.
+6. Close the app when finished.
+
+---
+
+## Requirements
+
+- **BlueStacks**: The app is designed to work with BlueStacks Android Emulator.
+- **Windows**: This app runs on Windows systems.
+
+---
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Error: Configuration file not found**:
+   - Ensure BlueStacks is installed and running.
+   - Verify that the `bluestacks.conf` file exists in the expected directory.
+
+2. **Status not updating**:
+   - Restart the app to refresh instance detection.
+   - Ensure the `.bstk` files are not locked by another process.
+
+3. **Permissions error**:
+   - Run the app as an administrator to ensure it can modify the necessary files.
+
+---
+
+## Development
+
+### For Developers
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/your-repo-name.git
+   cd your-repo-name
+   ```
+
+2. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. Run the app:
+   ```bash
+   python main.py
+   ```
+
+4. Build the `.exe` file:
+   ```bash
+   pyinstaller --onefile --windowed main.py
+   ```
+
+---
+
+## Contributions
+
+Contributions are welcome! Feel free to open an issue or submit a pull request.

config_handler.py

@@ -0,0 +1,37 @@
+def modify_config_file(config_path, setting, new_value):
+    """Modifies a setting in the BlueStacks configuration file.
+
+    Args:
+        config_path: The full path to the bluestacks.conf file.
+        setting: The name of the setting to modify (e.g., "bst.feature.rooting").
+        new_value: The new value for the setting (e.g., "1" or "0").
+    """
+    try:
+        with open(config_path, "r") as f:
+            lines = f.readlines()
+
+        with open(config_path, "w") as f:
+            for line in lines:
+                if line.startswith(setting + "="):
+                    f.write(f"{setting}=\"{new_value}\"\n")
+                else:
+                    f.write(line)
+    except FileNotFoundError:
+        print(f"Error: Configuration file not found at {config_path}")
+    except Exception as e:
+        print(f"Error modifying configuration file: {e}")
+
+def is_root_enabled(config_path, instance_name):
+    """Checks if root access is enabled for a specific instance in the configuration file."""
+    try:
+        with open(config_path, "r") as f:
+            for line in f:
+                if line.startswith(f"bst.instance.{instance_name}.enable_root_access="):
+                    return line.strip().endswith("=\"1\"")
+        return False  # Default to False if the setting is not found
+    except FileNotFoundError:
+        print(f"Error: Configuration file not found at {config_path}")
+        return False
+    except Exception as e:
+        print(f"Error reading configuration file: {e}")
+        return False

instance_handler.py

@@ -0,0 +1,61 @@
+from docx import Document
+import os
+
+def modify_instance_files(instance_path, file_names, new_type):
+    """Modifies the type of specified files within an instance's .bstk files.
+
+    Args:
+        instance_path: The path to the instance directory (e.g., ...\Engine\Rvc64).
+        file_names: A list of file names to modify (e.g., ["fastboot.vdi", "Root.vhd"]).
+        new_type: The new type to set (e.g., "Normal" or "Readonly").
+    """
+    for bstk_file_name in ["Android.bstk.in", f"{os.path.basename(instance_path)}.bstk"]:
+        bstk_file_path = os.path.join(instance_path, bstk_file_name)
+
+        try:
+            with open(bstk_file_path, "r") as file:
+                content = file.readlines()
+
+            modified = False
+            with open(bstk_file_path, "w") as file:
+                for line in content:
+                    for file_name in file_names:
+                        if file_name in line:
+                            line = line.replace("Readonly", new_type).replace("Normal", new_type)
+                            modified = True
+                    file.write(line)
+
+            if modified:
+                print(f"Modified file: {bstk_file_path}")
+            else:
+                print(f"No changes made to file: {bstk_file_path}")
+
+        except FileNotFoundError:
+            print(f"Error: Instance file not found at {bstk_file_path}")
+        except Exception as e:
+            print(f"Error modifying instance file: {e}")
+
+def is_instance_readonly(instance_path):
+    """Checks if the instance files are set to Readonly.
+
+    Args:
+        instance_path: The path to the instance directory.
+
+    Returns:
+        True if the instance files are in Readonly mode, False otherwise.
+    """
+    for bstk_file_name in ["Android.bstk.in", f"{os.path.basename(instance_path)}.bstk"]:
+        bstk_file_path = os.path.join(instance_path, bstk_file_name)
+
+        try:
+            with open(bstk_file_path, "r") as file:
+                for line in file:
+                    if "Readonly" in line:
+                        return True
+            return False
+        except FileNotFoundError:
+            print(f"Error: Instance file not found at {bstk_file_path}")
+            return False
+        except Exception as e:
+            print(f"Error reading instance file: {e}")
+            return False

kitsune_handler.py

@@ -0,0 +1,38 @@
+import subprocess
+import time
+
+def install_and_configure_kitsune(apk_path, instance_name):
+    """Attempts to install Kitsune Mask and perform the initial configuration.
+       HIGHLY CONCEPTUAL - Requires significant research and adaptation.
+
+    Args:
+        apk_path: Path to the Kitsune Mask APK.
+        instance_name: The name of the BlueStacks instance.
+    """
+    try:
+        # 1. Install the APK using ADB
+        adb_command = f"adb -s {instance_name} install {apk_path}"
+        subprocess.run(adb_command, shell=True, check=True)
+
+        # 2. Launch Kitsune Mask (you need to find the correct package and activity name)
+        adb_command = f"adb -s {instance_name} shell monkey -p com.example.kitsune 1"  # Replace com.example.kitsune
+        subprocess.run(adb_command, shell=True, check=True)
+
+        time.sleep(5)  # Wait for the app to launch
+
+        # 3. Simulate UI interactions using ADB shell input (VERY brittle)
+        #    You'll need to use 'adb shell input tap X Y' commands, where X and Y
+        #    are coordinates on the screen. These coordinates will be VERY specific to
+        #    the device/resolution and will likely break easily.
+        #
+        #    This sequence is EXTREMELY hypothetical and needs to be replaced with real
+        #    coordinates captured from a running emulator.
+        adb_command = f"adb -s {instance_name} shell input tap 100 200"  # Tap "Install" (example)
+        subprocess.run(adb_command, shell=True, check=True)
+        time.sleep(2)
+        adb_command = f"adb -s {instance_name} shell input tap 300 400"  # Tap "Direct Install to System" (example)
+        subprocess.run(adb_command, shell=True, check=True)
+        time.sleep(10) # Wait for installation
+
+    except Exception as e:
+        print(f"Error automating Kitsune Mask: {e}")