Skip to content

Commit 8abd9f1

Browse files
RobThePCGuyRobThePCGuy
authored
Update README.md
1 parent ac1ecc4 commit 8abd9f1

1 file changed

Lines changed: 63 additions & 158 deletions

File tree

‎README.md‎

Lines changed: 63 additions & 158 deletions
Original file line numberDiff line numberDiff line change
@@ -1,184 +1,89 @@
1-
# Root BlueStacks 5+ Rooting Guide (2025 Edition) with Kitsune Mask 🦊
1+
# BlueStacks Root GUI
22

3-
[![GitHub Repo Stars](https://img.shields.io/github/stars/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask?style=social)](https://github.com/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask)
4-
[![YouTube Video Views](https://img.shields.io/youtube/views/eRXeasi6GQQ?style=social)](https://youtu.be/eRXeasi6GQQ)
5-
[![Last Updated](https://img.shields.io/github/last-commit/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask)](https://github.com/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask/commits/main)
3+
![GUI Screenshot](https://github.com/user-attachments/assets/10f965eb-e1cc-4d61-9b6f-0cbb484a4ef0)
64

7-
**Root your BlueStacks 5+ emulator effortlessly using Kitsune Mask (formerly Magisk Delta)!** This guide provides a streamlined approach to granting root access to your BlueStacks instance, allowing you to run applications that require root privileges. No external tools or complex scripts are necessary – just your PC, Notepad, and Kitsune Mask!
5+
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/)**.
86

9-
[![Watch the Tutorial on YouTube](https://github.com/user-attachments/assets/d73e49bf-68fb-4b51-99eb-2b442d1be7cc)](https://youtu.be/eRXeasi6GQQ)
7+
## ✨ Features
108

11-
> [!NOTE]
12-
> **All-in-One Solution:**
13-
>
14-
> Root BlueStacks 5+ using just your *PC*, *Kitsune Mask*, and *Notepad*. **No external tools needed!** For a complete walkthrough, watch the video tutorial above or visit my [YouTube Channel](https://www.youtube.com/@RobThePCGuy).
15-
16-
> [!NOTE]
17-
> **BlueStacks Root GUI**
18-
> My Python based portable application 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 the configuration files I describe below.
19-
>
20-
> Check it out at **[BlueStacks-Root-GUI](https://github.com/RobThePCGuy/BlueStacks-Root-GUI)** and please leave feedback if you encounter any issues.
21-
22-
> [!IMPORTANT]
23-
> **Tested BlueStacks Version:**
24-
>
25-
> This guide is verified to work on **BlueStacks App Player `5.22.0.1102`** and supports Android 9, 11, and 13. This tutorial assumes you are using the master instance named **Rvc64** (Android 11).
26-
27-
> [!WARNING]
28-
> **Understanding Kitsune Mask and BlueStacks Partitions:**
29-
>
30-
> Kitsune Mask is a systemless root tool designed for Android devices. However, BlueStacks partitions are initially read-only, which prevents a direct Kitsune Mask installation. This guide uses a simple configuration file edit (via Notepad) to temporarily enable read/write permissions, allowing Kitsune Mask to be installed on the system partition. **No external scripts or tools are required for this permission change.**
31-
32-
## 🚀 Prerequisites
33-
34-
Before you begin, ensure you have the following:
35-
36-
- ✅ **PC with Administrator Rights:** You need administrative access to modify system files.
37-
- 🦊 **Kitsune Mask APK:** Download the latest APK from the [KitsuneMagisk repository](https://github.com/1q23lyc45/KitsuneMagisk/releases) (recommended fork).
38-
- 🔄 **Fresh BlueStacks Installation (Recommended):** For the most consistent results, start with a clean installation of [BlueStacks](https://www.bluestacks.com/). This minimizes potential conflicts during the rooting process.
39-
40-
## ✨ Expected Outcome
41-
42-
Upon successful completion of this guide, your BlueStacks instance will be fully rooted with Kitsune Mask, granting you the ability to run applications that require root privileges.
9+
- **Auto-detection:** Quickly identifies BlueStacks instances from the Windows Registry.
10+
- **Root Toggle:** Enables or disables root access **(`Root: On/Off`)** in `bluestacks.conf`.
11+
- **Read/Write Permissions:** Easily sets filesystem permissions **(`R/W: On/Off`)** per instance.
12+
- **Dynamic Status Updates:** Real-time GUI updates reflect current root and R/W states.
4313

44-
## 📝 Summary of Steps
14+
## 📥 Installation
4515

46-
Here's a quick overview of the rooting process. See the "Detailed Steps" section below for a comprehensive walkthrough:
16+
1. **Download** the latest executable (`.exe`) from the **[Releases](https://github.com/RobThePCGuy/BlueStacks-Root-GUI/releases)** page.
17+
2. **Run** the downloaded `.exe` file (portable—no formal installation needed).
18+
3. **Prerequisites:**
19+
**Fully Uninstall BlueStacks:**
20+
- 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)**.
21+
- Download the latest BlueStacks version from the official website: **[BlueStacks](https://www.bluestacks.com/)**.
4722

48-
- [x] **Step 1: Modify BlueStacks Configuration:** Edit `bluestacks.conf` to enable root access.
49-
- [x] **Step 2: Modify Instance Files:** Adjust settings in instance configuration files to allow read/write access to system partitions.
50-
- [x] **Step 3: Install Kitsune Mask:** Install Kitsune Mask directly to the `/system` partition and revert configuration changes.
23+
## 🎯 Usage
5124

52-
---
53-
54-
<details>
55-
<summary><h2>🛠️ Detailed Steps</h2></summary>
56-
57-
**Instance Naming Convention:**
58-
This tutorial uses the following naming conventions for master instances:
59-
60-
```
61-
Master Instances:
62-
- Tiramisu64 = Android 13 (beta)
63-
- Rvc64 = Android 11
64-
- Pie64 = Android 9
65-
```
66-
67-
*Adapt the instance names according to your BlueStacks setup.*
68-
69-
### Step 1: Prepare:
70-
1. **Fully Uninstall BlueStacks:**
71-
- 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)**.
72-
- Download and install the latest BlueStacks version from the official website: **[BlueStacks](https://www.bluestacks.com/)**.
73-
74-
### Step 2: Modify BlueStacks Config:
75-
1. **Locate the Main Configuration File:**
76-
Navigate to **`C:\ProgramData\BlueStacks_nxt`**.
77-
78-
2. **Edit with Notepad:**
79-
Open **`bluestacks.conf`** using your preferred text editor.
80-
81-
3. **Modify Configuration Values:**
82-
- Change **`bst.feature.rooting="0"`** to **`bst.feature.rooting="1"`**.
83-
- Change **`bst.instance.Rvc64.enable_root_access="0"`** to **`bst.instance.Rvc64.enable_root_access="1"`**.
84-
> **Note:** If you are using a different instance (e.g., Pie64 or Tiramisu64), modify the [InstanceName] for all the lines similar to this: `bst.instance.[InstanceName].enable_root_access`.
85-
86-
4. **Save Changes:**
87-
Save the modified **`bluestacks.conf`** file.
88-
89-
### Step 3: Enable R/W:
90-
91-
1. **Navigate to the Master Instance Folder:**
92-
Go to **`C:\ProgramData\BlueStacks_nxt\Engine\Rvc64`** (or your instance folder, e.g., `Pie64` or `Tiramisu64`).
93-
> **Note:** Cloned instances do not make a copy of the **`Android.bstk.in`** file; it will always be found within the master instance directory.
94-
2. Open **`Android.bstk.in`** with Notepad (or your text editor).
95-
3. **Change Partition Permissions:**
96-
- For the **`location="fastboot.vdi"`** and **`location="Root.vhd"`** entries, change the attribute from **`type="Readonly"`** to **`type="Normal"`**.
97-
- **Example:**
98-
```diff
99-
- location="fastboot.vdi" format="VDI" type="Readonly" />
100-
- location="Root.vhd" format="VHD" type="Readonly"/>
101-
102-
+ location="fastboot.vdi" format="VDI" type="Normal" />
103-
+ location="Root.vhd" format="VHD" type="Normal"/>
104-
```
105-
- Save the file.
106-
107-
> **Note:** If you are rooting the master instance **`Rvc64`**, then this file will be located in the master instance folder **(`C:\ProgramData\BlueStacks_nxt\Engine\Rvc64`)**.
108-
> **Note:** If you have cloned (or copied) the master instance, the folder and file might be named something like `Rvc64_1`. In this case, replace the instance name in the instructions accordingly.
109-
4. Open **`Rvc64.bstk`** with Notepad (or your text editor).
110-
5. **Change Partition Permissions:**
111-
- For the **`location="fastboot.vdi"`** and **`location="Root.vhd"`** entries, change the attribute from **`type="Readonly"`** to **`type="Normal"`**.
112-
- **Example:**
113-
```diff
114-
- location="fastboot.vdi" format="VDI" type="Readonly" />
115-
- location="Root.vhd" format="VHD" type="Readonly"/>
116-
117-
+ location="fastboot.vdi" format="VDI" type="Normal" />
118-
+ location="Root.vhd" format="VHD" type="Normal"/>
119-
```
120-
- Save the file.
121-
122-
### Step 4: Install Kitsune Mask
123-
124-
1. Download the **[Kitsune Mask](https://github.com/1q23lyc45/KitsuneMagisk/releases)** apk file.
125-
2. Launch the instance from the Multi-Instance Manager and install the apk.
126-
3. You should see the Kitsune Mask application; click on it to run.
127-
4. Root using **Kitsune Mask**:
25+
1. Launch the downloaded `.exe` file.
26+
2. The GUI auto-detects and lists all available BlueStacks instances.
27+
3. Select the instances you wish to modify.
28+
4. Use provided toggles:
29+
- **Toggle Root** – Switch this **ON** only until you have installed Kitsune to **`/system`**.
30+
- **Toggle R/W** – This must be **ON** for the instance to remain rooted.
31+
5. Download the **[Kitsune Mask](https://github.com/1q23lyc45/KitsuneMagisk/releases)** apk file.
32+
6. Launch the instance from the Multi-Instance Manager and install the apk.
33+
7. You should see the Kitsune Mask application; click on it to run.
34+
8. Root using **Kitsune Mask**:
12835
- Once open, look to the top under the Kitsune Mask section and select the **Install** option.
12936
- At the top right, tap the **Next** link to proceed.
13037
- Select the **Direct Install to /system** option.
13138

132-
> **Note:** If the **Direct Install to /system** option is missing, do not select **Direct Install**.
39+
>[!NOTE]
40+
> If the **Direct Install to /system** option is missing, do not select **Direct Install**.
13341
>
13442
> Completely close and reopen the Kitsune Mask app. This usually resolves the issue.
13543
136-
5. Click Next and watch the install log for any errors.
137-
6. Allow Kitsune Mask to finish installing, then close the BlueStacks emulator.
138-
7. Open up the Main Configuration File: **`bluestacks.conf`**.
139-
- Change the value for **`bst.instance.Rvc64.enable_root_access="1"` back to `bst.instance.Rvc64.enable_root_access="0"` (or the corresponding line for your instance, e.g., Pie64 or Tiramisu64).
140-
> **Note:** The file will have automatically changed the value for **`bst.feature.rooting=`** back to **`"0"`**, this is normal and an important part of the process
141-
- Save the file.
44+
9. Click Next and watch the install log for any errors.
45+
10. Allow Kitsune Mask to finish installing, then close the BlueStacks emulator.
46+
11. Use the provided toggles:
47+
- **Toggle Root** – Switch this **OFF** once the Kitsune Mask install has been completed.
48+
- **Toggle R/W** – This must be **ON** for the instance to remain rooted.
49+
12. Close the BlueStacks-Root-Gui.
14250

143-
</details>
51+
## ⚠️ Troubleshooting
14452

145-
<details>
146-
<summary><h2>Troubleshooting 🐛</h2></summary>
53+
### Common Issues:
54+
- **Configuration not found:**
55+
**Fully Uninstall BlueStacks:**
56+
- 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)**.
57+
- Download the latest BlueStacks version from the official website: **[BlueStacks](https://www.bluestacks.com/)**.
58+
- **Permissions errors**: Run the GUI as an administrator.
14759

148-
- **Kitsune Mask Installation Issues:**
149-
- **Problem:** Kitsune Mask fails to install or encounters errors.
150-
- **Solution:**
151-
- **Fully Uninstall BlueStacks:**
152-
- 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)**.
153-
- Download and install the latest BlueStacks version from the official website: **[BlueStacks](https://www.bluestacks.com/)**.
60+
## 👩‍💻 Development
15461

155-
- **Kitsune Mask App Crashing or Not Opening:**
156-
- **Problem:** The Kitsune Mask app crashes or fails to launch.
157-
- **Solution:** Reinstall the Kitsune Mask APK from the [KitsuneMagisk repository](https://github.com/1q23lyc45/KitsuneMagisk/releases) and restart your BlueStacks instance.
62+
### Getting Started:
15863

159-
</details>
160-
161-
<details>
162-
<summary><h2>❓ FAQ - Frequently Asked Questions</h2></summary>
163-
164-
**Q: I can't find the `bluestacks.conf` or instance configuration files!**
165-
**A:**
166-
1. **Administrative Access:** Verify that you are logged in with an account that has administrator privileges.
167-
2. **Correct Directory:** Double-check that you are navigating to `C:\ProgramData\BlueStacks_nxt\`. Also, ensure that hidden folders are visible in your file explorer settings.
64+
**Clone the repo:**
65+
```bash
66+
git clone https://github.com/RobThePCGuy/BlueStacks-Root-GUI.git
67+
cd BlueStacks-Root-GUI
68+
```
16869

169-
**Q: This all seems terribly difficult; isn't there a better way?**
170-
**A:** Yes, there is!
171-
- Try using [BlueStacks-Root-GUI](https://github.com/RobThePCGuy/BlueStacks-Root-GUI), which lets you change the configuration values with simple checkboxes. After that, simply follow along with the Kitsune Mask installation.
70+
**Install dependencies:**
71+
```bash
72+
pip install -r requirements.txt
73+
```
17274

173-
**Q: Can I reverse this rooting process?**
174-
**A:** Yes, the process is reversible.
175-
1. **Revert Configuration Changes:** Undo the edits made to `bluestacks.conf` (change the `1`s back to `0`s).
176-
2. **Uninstall Kitsune Mask:** Remove the Kitsune Mask app from within your BlueStacks instance.
75+
**Run the application:**
76+
```bash
77+
python main.py
78+
```
17779

178-
</details>
80+
**Build executable:**
81+
```bash
82+
pyinstaller --onefile --windowed --icon=main.ico main.py
83+
```
17984

180-
---
85+
The built executable will be located in the `dist/` folder.
18186

182-
🙏 **If this guide has helped you root your BlueStacks instance, please consider leaving a star on the repository!** ⭐ It helps others discover this guide and motivates further improvements.
87+
## 🤝 Contributing
18388

184-
[GitHub Repository](https://github.com/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask)
89+
Contributions are highly encouraged! Please open issues or submit pull requests to enhance this project.

0 commit comments

Comments
 (0)