-
Notifications
You must be signed in to change notification settings - Fork 5
Frequently Asked Questions (FAQ)
Welcome to the NetToggle FAQ. If you are experiencing issues or have questions about how the app works, you will likely find the answer here.
Q: Why does NetToggle require Root or Shizuku?
A: Changing the preferred network type (like forcing 5G/4G Only) requires elevated system-level permissions (MODIFY_PHONE_STATE). Standard Android apps cannot hold this permission. NetToggle uses Root or Shizuku to securely communicate directly with the Android telephony framework to bypass this restriction.
Q: Why does NetToggle require the "Read Phone State" permission?
A: This is an optional permission used strictly for performance. By granting "Read Phone State", NetToggle can use fast, native Android APIs (SubscriptionManager) to instantly detect your active SIM card and network capabilities. Without it, the app must fall back to slower background shell commands (dumpsys), which can introduce lag when tapping the Quick Settings tile.
Q: Why does NetToggle require the "Run at startup" (Receive Boot Completed) permission?
A: NetToggle does not run persistent background services that drain your battery. It only uses the startup permission for a split-second when you turn on your phone to clear stale Quick Settings tile data. This ensures that the tile accurately fetches the true network state from the system, rather than displaying incorrect, cached data from before the reboot.
Q: I selected "Root", but my device didn't ask for permission and the app isn't working.
A: Modern root managers (like KernelSU, APatch, and sometimes Magisk) no longer automatically prompt you when an app requests root access in the background. You must open your root manager app, go to the Superuser/Permissions tab, find NetToggle, and manually toggle the switch to grant access.
Q: Shizuku is running, but NetToggle says "Permission Denied" or "Shizuku Unavailable".
A: Ensure that you have actually allowed NetToggle within the Shizuku app. Open Shizuku, tap on "Authorized applications", and ensure the toggle next to NetToggle is turned on. If you recently rebooted your phone, you must start the Shizuku service again before the tile will work.
Q: Does NetToggle support 5G Ultra Wideband (UW / UC)?
A: Yes. Setting the mode to 5G Only (NR) or Pref 5G (NR/LTE) enables full access to mid-band (C-Band) and mmWave frequencies. Your carrier and baseband modem will automatically prioritize Ultra Wideband whenever it is in range.
Q: What is the difference between 5G SA (Standalone) and 5G NSA (Non-Standalone)?
A: 5G NSA (Non-Standalone / Dual Connectivity):
- In NSA mode, the modem uses LTE (4G) as the anchor and signaling backbone while attaching to a 5G NR (New Radio) carrier as a high-speed secondary data channel (a mechanism known as EN-DC / E-UTRA-NR Dual Connectivity).
- Calls (VoLTE), initial network registration, and handovers go through LTE, while active downloads and uploads can utilize 5G bandwidth.
- Most commercial carrier deployments today (including Verizon 5G Ultra Wideband, AT&T 5G+, and many international networks) operate primarily on 5G NSA.
5G SA (Standalone):
- In SA mode, the device communicates strictly and exclusively with the 5G Core network (5GC) without needing an LTE anchor band.
- Calls require VoNR (Voice over New Radio) support, and the tower must broadcast a dedicated Standalone 5G signal.
Q: Why does selecting "5G Only" completely drop my mobile connection or act like data is turned off?
A: When you force "5G Only", NetToggle instructs the cellular modem to disable 4G/3G/2G radio access technologies entirely and search exclusively for 5G Standalone (5G SA) towers.
Your connection drops to "No Service" or disconnected state if:
- Your carrier uses 5G NSA in your area: In NSA mode, the modem must connect to 4G LTE first to establish the 5G data link. Because LTE is disabled in "5G Only" mode, the phone cannot connect to the tower.
- Your SIM card or plan is not provisioned for 5G SA / VoNR: Even if the tower supports SA, carriers often restrict SA access to specific SIM plans.
- Your device firmware limits 5G SA: OEM firmware (such as Samsung CSC or regional carrier locks) may disable SA on specific networks.
Tip: If your carrier uses 5G NSA (or you want 5G Ultra Wideband / 5G+ without dropped calls), use "Prefer 5G" instead of "5G Only".
Q: What is the difference between each Network Mode in NetToggle?
A:
| Mode | What It Does Under the Hood | Best For |
|---|---|---|
| Prefer 5G (5G / LTE / 3G / 2G) | Allows 5G NSA (EN-DC), 5G SA, 4G LTE, and legacy fallback. Actively requests 5G/UW/5G+ when available while retaining LTE anchoring. | Recommended for daily 5G use, 5G Ultra Wideband, and reliable calls/data. |
| 5G Only (NR Only) | Forces the modem to connect strictly to 5G Standalone (5G SA). All 4G LTE, 3G, and 2G radio bands are disabled. | Pure 5G SA networks (e.g., T-Mobile SA, Jio 5G True5G, specialized 5G private networks). |
| Prefer 4G (LTE / 3G / 2G) | Disables 5G modems entirely while keeping 4G LTE, 3G, and 2G active. | Battery saving, reducing phone heat, or avoiding unstable/flickering 5G fringe areas. |
| 4G Only (LTE Only) | Locks the modem to LTE. Drops connection if 4G signal is lost instead of degrading to 3G/2G. | Ensuring high-speed data without falling back to slow 2G/3G in weak signal pockets. Requires VoLTE for phone calls. |
| Prefer 3G (3G / 2G) | Disables 4G and 5G; allows UMTS/HSPA/GSM connections. | Ultra-low bandwidth or legacy 3G network testing. |
| 2G Only (GSM / EDGE Only) | Locks to basic 2G cellular network. | Extreme battery conservation, emergency standby, or basic voice/SMS where 2G is still active. |
Q: Why does the 5G UW (Ultra Wideband) / 5G+ icon appear and disappear even when I am near a tower?
A: This is a standard network battery-saving feature called SCG Release (Secondary Cell Group release):
- When your phone is idle (e.g., browsing a static page or in standby), the tower and device release the high-frequency 5G NR carrier to prevent overheating and conserve battery, showing the standard 5G or LTE indicator.
- As soon as a high-bandwidth task starts (streaming video, running a speed test, downloading a file), the network immediately attaches the Ultra Wideband (
$n77$ C-band or$n260/n261$ mmWave) secondary carrier, and the 5G UW / 5G+ icon appears. - Setting "Prefer 5G" in NetToggle helps keep the modem prioritized for 5G aggregation whenever data demand arises.
Q: Will I still receive incoming phone calls when using "4G Only" or "5G Only"?
A:
- 4G Only: Phone calls will work as long as VoLTE (Voice over LTE) is enabled and supported by your carrier. If VoLTE is unsupported or disabled, incoming/outgoing calls will fail because the phone cannot fall back to 3G/2G for voice.
- 5G Only: Phone calls require VoNR (Voice over New Radio) and a fully provisioned 5G Standalone network. On NSA networks, calls will fail because 2G/3G/4G CSFB and VoLTE fallbacks are blocked.
- Prefer 5G / Prefer 4G: Phone calls are 100% safe and will seamlessly route through VoNR, VoLTE, or legacy 3G/2G as supported by the carrier.
Q: Why can't I make or receive phone calls when using "4G Only" or "5G Only"?
A: When you lock your device to 4G or 5G only, you disable the ability for the phone to fall back to legacy 3G/2G networks for voice calls. To make calls on 4G/5G, your carrier and device must support and have VoLTE (Voice over LTE) or VoNR (Voice over NR) actively provisioned and enabled. If calls are dropping, switch back to a "Preferred" mode.
Q: Can NetToggle damage my SIM card or modem hardware?
A: No. NetToggle communicates directly with Android's official Telephony subsystem (ITelephony / SubscriptionManager / RadioAccessFamily) using standard system APIs and commands. It applies standard radio preferences that are built into Android's core telephony stack without modifying device firmware, baseband partitions, or hardware limits.
Q: Why isn't there a "Preferred 2G" option?
A: At the hardware level, Android modems do not support a "Preferred 2G" state that falls back upward to 3G or 4G. Modems naturally camp on the highest available generation. To restrict your phone to 2G, you must use the 2G Only mode.
Q: Why are some modes (like "5G Only" or "2G Only") disabled or greyed out in the app?
A: NetToggle dynamically checks your device hardware and current carrier configuration. If your phone's hardware does not support 5G, or if your carrier has permanently shut down their 2G/3G networks (e.g., US Carriers, Jio India, Telstra Australia), the app automatically disables those options to prevent you from selecting a mode that would result in a total loss of service.
Q: Does NetToggle support Dual SIM devices?
A: Yes! By default, the app is set to Auto, which dynamically detects your active data SIM and applies the network change to it (this includes zero-battery SIM-swap detection). You can also manually force changes to SIM 1 or SIM 2 via the Target SIM card in the app.
Q: Is this app safe for AMOLED screens in Dark Mode?
A: Yes. As of our Material 3 overhaul, the dark theme utilizes a pure black (#000000) background to maximize battery efficiency and prevent burn-in on OLED/AMOLED displays.
Q: The Quick Settings Tile isn't updating or doing anything when I tap it.
A: Check two things:
- Ensure you have actually selected modes in the Quick Tile Cycle card inside the main app. (If no modes are selected, the tile has nothing to cycle through).
- Ensure your Execution Mode (Root or Shizuku) is active and properly granted.
Q: I tapped a mode in the tile, but it says "Error Check App". What went wrong?
A: This means the underlying shell command failed to execute properly. Open the main NetToggle app, and you will see a red "Command Failed" banner. Tap it to view and copy a detailed Diagnostic Report, which you can share with the developer to help fix the issue.
Q: The app says "Auto SIM detection failed", what should I do?
A: On some custom ROMs or highly modified manufacturer software, Android cannot accurately report which SIM is actively being used for data. If you see this warning, simply select SIM 1 or SIM 2 manually under the Target SIM card.
Q: I found a bug or have a feature request. Where can I contact the developer?
A: You can open an issue here on GitHub, or join our community group on Telegram for faster support and discussions: Join the Project Chat.