Troubleshooting Connection Issues
Solutions for common phone connection problems including driver issues, ADB errors, and intermittent disconnections.
Phone Not Detected
If Add phone stays on Waiting for a phone on USB...:
- Check that USB debugging is on. On GrapheneOS, it must be on the Owner profile.
- Try another cable. Charge-only cables never show the phone.
- Try another USB port, directly on the computer rather than a hub.
- Unlock the phone and look for the Allow prompt.
- Click Refresh on the Phones tab.
ShadowPhone installs ADB itself, so there is nothing else to install.
Waiting for Allow
The phone card says Waiting for Allow, and Overview says the phone is waiting for USB approval. Unlock the phone, tap Allow on the USB debugging prompt, then click Refresh.
No prompt? In Developer options, tap Revoke USB debugging authorizations, unplug the phone, plug it back in, and tick Always allow from this computer this time.
Phone Shows Offline
Reconnect its USB cable, then click Refresh. If it keeps dropping, the usual causes are a worn cable, a hub without enough power, Windows USB power saving, or the phone sleeping. Turn off USB selective suspend in Windows power options and turn on Stay awake in the phone's Developer options.
Windows Driver Issues
Some phones need their maker's USB driver on Windows; Pixels use the Google USB Driver from developer.android.com. Install it if the phone charges but never shows up, then reconnect.
Runs Don't Start: Check the Brain
Runs need the Brain, the engine that runs on this computer. Its pill in the top bar says Brain Ready, Starting or Down. Click it for Refresh and Open logs folder, and Restart when it's down.

Still Having Issues?
Contact support with your computer's OS version, phone model, ShadowPhone version and any error message. Schedule > ··· > Copy app logs copies the app's logs so you can include them.
Need more help?
Contact support for help with your setup, or browse the rest of the docs.