Shizuku guide

Phones

GrapheneOS

GrapheneOS runs on Pixel phones and follows the Pixel steps, with one extra security switch.

On this page

1. Turn on Developer options

  1. Open Settings.

  2. Go to Settings, then About phone, then Build number and tap Build number 7 times.

  3. Enter your PIN if asked. You see You are now a developer!

  4. Developer options is in Settings, then System, then Developer options.

  5. Turn on USB debugging.

Sources: Android developer options docs

2. Extra switches this brand needs

  1. Open Settings, then Security.

  2. Turn off Secure app spawning. Shizuku's manual says you may need to.

Older builds also blocked adb from running code inside the app file. Keep GrapheneOS up to date.

Sources: Shizuku setup guide, Issue 226

3. Pair and start

Follow the Wireless debugging steps. On a computer instead? The computer steps.

Sources: Shizuku setup guide

4. Keep Shizuku from stopping

  1. Open Settings, then Apps, then Shizuku, then App battery usage.

  2. Turn on Allow background usage, tap the row and choose Unrestricted.

Also do the four steps every phone needs: unrestricted battery, Disable adb authorization timeout, No data transfer as the USB default, and leaving debugging on. They are on the Wireless page.

Sources: Don't kill my app: Google

5. Known problems on GrapheneOS

Shizuku won't start

Turn off Secure app spawning (step 2).

Sources: Shizuku setup guide, Issue 226

6. Turn it all back off

  1. First, in each app that used Shizuku, undo what it changed, while Shizuku still runs. Some changes an app makes through Shizuku stay after Shizuku stops. Firewall and Fileglow have their own steps.

  2. In Shizuku, switch off every app in the list of authorized apps.

  3. Stop Shizuku with its stop option, or restart the phone.

  4. Open Developer options, then Wireless debugging, then Paired devices, tap the shizuku entry, then Forget.

  5. In Developer options, tap Revoke USB debugging authorizations. This removes every paired computer and device.

  6. Turn Secure app spawning back on in Settings, then Security.

  7. Turn off Disable adb authorization timeout if you turned it on, and set Default USB configuration back to File transfer if you want.

  8. Turn off Wireless debugging, then USB debugging.

  9. Turn off the switch at the top of Developer options: Settings, then System, then Developer options.

  10. Set Shizuku's battery setting back to the default (Optimized) if you like.

  11. Uninstall Shizuku the normal way if you don't need it any more.

Sources: Shizuku setup guide, Android adb docs, Android developer options docs, Issue 467, Issue 451, Discussion 1000