Skip to content

1. Execution Mode Configuration

Jump to bottom
DK edited this page Sep 14, 2026 · 2 revisions

To communicate directly with Android's underlying telephony subsystem (ITelephony / RadioAccessFamily) and switch cellular network modes, NetToggle requires elevated privileges. You can configure your preferred execution environment: Shizuku (Recommended) or Root.

🌟 Option A: Shizuku Mode (Recommended for Both Non-Rooted & Rooted Devices)

Shizuku is the recommended execution mode for all users.

  • Why Shizuku is Recommended:
    • It provides lightning-fast native binder communication without the process overhead of spawning heavy su root shell processes on every toggle.
    • Works completely without root using Android's built-in Wireless Debugging (ADB).
    • On rooted devices, Shizuku can start automatically with root permissions on boot, giving you the best of both worlds: persistent startup with high binder efficiency.

Supported Apps & Recommended Forks:

  • Official Shizuku: The standard release available via Google Play, F-Droid, and GitHub.
  • ShizukuPlus / Trusted Forks: Enhanced community forks that offer extended features such as automatic start-on-boot via background service, watchdog persistence, or automated TCP port reconnection.

Setup Steps:

  1. Install Shizuku (or a recommended fork) on your device.
  2. Start the Shizuku service by following the Official Shizuku Setup Guide:
    • Non-Rooted: Start via Wireless Debugging or via a one-time ADB command from a PC.
    • Rooted: Simply tap Start (with Root) inside the Shizuku app.
  3. Once the app shows "Shizuku is running", open NetToggle.
  4. On the Execution Mode card, select the Shizuku segment.
  5. A system dialog will appear asking for authorization. Tap Allow all the time.
  6. Verification: NetToggle will update its status badge to: 
    Shizuku mode active & authorized!

⚡ Option B: Direct Root Mode (su)

If your device is rooted and you prefer not to keep Shizuku running in the background, NetToggle can execute commands directly through your superuser binary. Compatible with Magisk, KernelSU, and APatch.

Setup Steps:

  1. Open NetToggle and locate the Execution Mode card on the main dashboard.
  2. Select the Root segment.
  3. Granting Root Permission:
    • Magisk: A superuser prompt will appear automatically. Tap Grant.
    • KernelSU / APatch: If a popup prompt does not automatically display, open your root manager app (KernelSU or APatch), go to the Superuser / Modules tab, find NetToggle, and toggle superuser access to Grant / Allow.
  4. Verification: NetToggle will update its status badge to: 
    Root mode active & authorized!

🔍 Verification & Troubleshooting

  • Authorization Lock: When an execution mode is not yet authorized or the service is inactive, dependent cards (Target SIM, Quick Tile Cycle, Shortcuts, and Broadcasts) will dim with a lock badge. Tapping any action will guide you with a helpful authorization toast.
  • Diagnostics: If execution encounters errors or commands fail, tap the red diagnostic banner at the top of the app to view the exact command, exit code, and raw shell output logs (stdout / stderr).

Clone this wiki locally