-
-
Notifications
You must be signed in to change notification settings - Fork 81
Setup
Get the latest stable or beta version. All versions are distributed via GitHub Releases.
You may need to allow "Install unknown apps" or bypass/temporarily disable Play Protect to install the APK.
Important
If you are using the original Shizuku, you MUST uninstall it before installing this fork. Additionally, if you start Shizuku via wireless debugging, you should also un-pair the original Shizuku from wireless debugging.
There are 3 methods for starting Shizuku. Below is a comparison table:
| Mode | On-Device | Start on Boot | Start Without Wi-Fi | Non-Root | Min. Android Version |
|---|---|---|---|---|---|
| Root | ✅ | ✅ | ✅ | ❌ | 7 |
| Wireless Debugging | ✅ | ✅* | ❌ | ✅ | 11 |
| PC | ❌ | ❌ | ✅ | ✅ | 7 |
*Only starts automatically once connected to Wi-Fi.
In most cases, Root mode is preferred for rooted devices, Wireless debugging mode is preferred for unrooted Android 11+ devices, and PC mode is required for unrooted devices running Android 10 or below.
Warning
On non-rooted devices, USB debugging must stay enabled to keep the privileged service alive. While generally safe, this setting can make your device more vulnerable to attacks. Never accept an authorization prompt while connected to an unfamiliar USB port.
There is an option in Shizuku to auto-disable USB debugging when stopping the privileged service. If you do not need USB debugging for any other reason, you can enable this option to reduce the risk of attacks.
Root users can start the service directly from the app.
If prompted, grant Shizuku the superuser permission.
This method requires a one-time pairing setup. Once Shizuku is paired, you can start the service directly from the app.
Important
Wi-Fi is required to pair and start Shizuku with wireless debugging. If you enable TCP mode in settings, Wi-Fi is required only once per reboot.
- Open Shizuku and tap the "Pair" button. You should see a notification appear, which will be used to complete the pairing process.
- Enable Developer Options if not already enabled (Generally, this is done by going to
Settings > About deviceand tappingBuild number7 times). - Navigate to Developer Options (generally located on the main Settings page or under
System).
Note
Directions to enable and open developer options may vary by device. Please look up the instructions for your manufacturer.
- Enable both
USB debuggingandWireless debugging. Tap "Allow" if prompted to allow wireless debugging on the current network. - Tap the
Wireless debuggingrow (not just the toggle) to enter theWireless debuggingsub-screen. - Tap
Pair device with pairing code. - Enter the code displayed on the screen in the pairing notification. If successful, the notification will display a success message.
Important
You'll need to connect your device to a computer and run the command every time you want to start Shizuku. Alternatively, you can run the adb tcpip 5555 command once after reboot. This lets you start Shizuku without a computer until the next reboot.
- Enable Developer Options if not already enabled (Generally, this is done by going to
Settings > About deviceand tappingBuild number7 times). - Navigate to Developer Options (generally located on the main Settings page or under
System). - Enable USB debugging.
Note
Directions to enable and open developer options may vary by device. Please look up the instructions for your manufacturer.
- Install SDK Platform Tools from Google and extract the files to a new folder.
Tip
You can add the folder to your PATH environment variable. This lets you run the ADB command from any terminal window. This process is different for Windows, Mac, and Linux devices. Please look up the instructions for your operating system.
- Open a terminal. If you did not add the ADB folder to your PATH, make sure to either:
- Open the terminal from the ADB folder by right-clicking inside the folder (you may need to hold Shift to see the option), or
- Execute
cd path/to/adb/folderto set the working directory to the ADB folder.
- Connect your device to the computer with a USB cable.
- Type
adb devicesinto the terminal and hit enter. - An "Allow USB debugging" prompt may appear on your device. If so, check "Always allow" and accept the prompt.
- Open Shizuku and tap the "View command" button.
- Copy the command and paste it in your terminal. Shizuku should start successfully.
Note
The command shown in the app is unique to every device.
Once the service is running, you can manage which apps are allowed to use Shizuku from the Authorized Applications screen. Apps may also show you a dialog asking for the Shizuku permission.
Warning
Like any normal permission, you should only grant the Shizuku permission to apps that you trust. Shizuku is a powerful tool, and malicious apps could use the Shizuku permission to harm your device or access your data.