Skip to content

Commit ac1ecc4

Browse files
RobThePCGuyRobThePCGuy
authored
Update README.md
1 parent 866498b commit ac1ecc4

1 file changed

Lines changed: 157 additions & 63 deletions

File tree

‎README.md‎

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

3-
![GUI Screenshot](https://github.com/user-attachments/assets/10f965eb-e1cc-4d61-9b6f-0cbb484a4ef0)
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)
46

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/)**.
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!
68

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

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.
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.
1343

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

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/)**.
46+
Here's a quick overview of the rooting process. See the "Detailed Steps" section below for a comprehensive walkthrough:
2247

23-
## 🎯 Usage
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.
2451

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**:
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**:
35128
- Once open, look to the top under the Kitsune Mask section and select the **Install** option.
36129
- At the top right, tap the **Next** link to proceed.
37130
- Select the **Direct Install to /system** option.
38131

39-
>[!NOTE]
40-
> If the **Direct Install to /system** option is missing, do not select **Direct Install**.
132+
> **Note:** If the **Direct Install to /system** option is missing, do not select **Direct Install**.
41133
>
42134
> Completely close and reopen the Kitsune Mask app. This usually resolves the issue.
43135

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.
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.
50142

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

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.
145+
<details>
146+
<summary><h2>Troubleshooting 🐛</h2></summary>
59147

60-
## 👩‍💻 Development
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/)**.
61154

62-
### Getting Started:
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.
63158

64-
**Clone the repo:**
65-
```bash
66-
git clone https://github.com/RobThePCGuy/BlueStacks-Root-GUI.git
67-
cd BlueStacks-Root-GUI
68-
```
159+
</details>
69160

70-
**Install dependencies:**
71-
```bash
72-
pip install -r requirements.txt
73-
```
161+
<details>
162+
<summary><h2>❓ FAQ - Frequently Asked Questions</h2></summary>
74163

75-
**Run the application:**
76-
```bash
77-
python main.py
78-
```
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.
79168

80-
**Build executable:**
81-
```bash
82-
pyinstaller --onefile --windowed --icon=main.ico main.py
83-
```
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.
172+
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.
84177

85-
The built executable will be located in the `dist/` folder.
178+
</details>
86179

87-
## 🤝 Contributing
180+
---
88181

89-
Contributions are highly encouraged! Please open issues or submit pull requests to enhance this project.
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.
90183

184+
[GitHub Repository](https://github.com/RobThePCGuy/Root-Bluestacks-with-Kitsune-Mask)

0 commit comments

Comments
 (0)