Remote Control
Troubleshoot viewer connection
Fix Cloud Phone viewer issues: black screen, lag, timeouts and offline devices. Plus what each status overlay, the ping indicator and the VPN banner mean.
4 min read
Sometimes the viewer won't show a picture or feels sluggish. This page lists the common symptoms with fixes ordered easiest first, then explains the on-screen messages and the ping indicator.
Why is my Cloud Phone screen black?
The viewer says it is connected, audio works, input registers, but the video area stays black. The usual cause is a decode mode that doesn't suit your browser or computer, not a broken cloud phone.
Click Settings (gear icon, at the end of the resolution chip row).
Find Decode path and choose Video. It suits low-end devices and is the most compatible option. The viewer reconnects automatically after the switch.
If it is still black, hit Refresh on the toolbar to rebuild the stream.
Still black? Click Report a problem (bug icon) in the panel header and pick the black-screen report. Support needs it to find the root cause.
WebCodecs is more responsive but browser-dependent. If your browser lacks support, the chip is greyed out: "Not supported by this browser."
Why does the viewer open with no image?
The viewer window appears but the video area stays dark, showing only the Connecting overlay with rotating tips.
Check your internet speed. Aim for at least 10 Mbps download.
Refresh the dashboard page (F5 or Cmd+R), then open the viewer again.
Sign out, sign back in, and open the viewer from scratch.
Switch to the latest Chrome or Firefox if you're on another browser.
Why is the picture laggy?
You can see the cloud phone, but actions feel slow and frames stutter.
Drop the resolution to 360P or 720P with the chip row under the toolbar. Fastest win.
Open Settings and set Quality preference to Prefer speed. It adapts to your network, keeping motion smooth and lowering sharpness when the connection dips. It only appears if your device supports it.
Disable any VPN or proxy on your computer (yours, not anything inside the cloud phone). VPNs add latency.
Close other bandwidth-heavy apps: video streams, torrents, online games.
A wired connection usually beats Wi-Fi by a wide margin for lag.
Why won't the viewer connect (timeout)?
The Connecting overlay shows, then flips to Offline with the hint "Just rebooted or factory reset? Please wait a moment. If it keeps failing, contact support."
Press Retry on the overlay to re-send the connection request.
If the device just rebooted or was reset, give it more time. A reboot takes at least 3 minutes, a factory reset around 10.
Still nothing? Press Force reboot on the overlay to restart the device.
Your network may block the ports the viewer needs. Hotspot from your phone on mobile data, connect your computer, and reopen the viewer. If it works there, the original network is the problem.
Disable browser extensions (especially ad-blockers and privacy extensions) and retry.
Contact support with: your account email, the Session ID, when it happened, and the network you were on.
What do the viewer's on-screen messages mean?
The overlay in the middle of the screen names the device's current state — connecting, offline, restarting, or recovering. Reading it correctly saves time.
| Message | What it means and what to do |
|---|---|
Connecting with (1/5) | The viewer is retrying; the number is the attempt count. Just wait. |
| Offline | The device isn't responding. Use Retry or Force reboot. If it just rebooted or was reset, wait longer. |
| Can't reach the server. Retrying… (amber) | A network problem between you and the server, not a broken device. Check your connection and let it reconnect. |
| Unstable network. Reconnecting… | Flaky connection. Lower the resolution or switch to wired. |
| Device is restarting… | Usually at least 3 minutes. Wait it out. |
| Setting up your device… | Applying new device info. Can take a few minutes. |
| Resetting your device… | Factory reset in progress, about 10 minutes. |
| Device is updating… | Updating, should return shortly. |
| Device hit an error and is recovering. | Self-recovery in progress, wait around 30 seconds. |
What does the ping colour mean?
The "XX ms" pill on screen is your round-trip latency, and its colour grades the connection at a glance:
- Green: under 80ms, excellent.
- Amber: under 150ms, latency is noticeable.
- Red: 150ms or above, clearly laggy. Lower the resolution or change network.
Click or hover the pill for RTT, Bitrate, FPS, Jitter. Toggle it in Settings → Stats overlay, or with Toggle ping on mobile.
Why does the viewer say "VPN recommended"?
Because an app open on the device needs a VPN to sign in. The viewer shows a VPN recommended banner: "You may not be able to sign in without a VPN. Turn it on for a stable connection." Choose Turn on VPN, Dismiss, or tick Don't show again.
The viewer needs a browser with real-time video (WebRTC). Very old browsers (IE11, ancient Chrome) won't run it.
How can I prevent viewer problems?
- Use the latest Chrome or Firefox.
- Aim for 10+ Mbps download for smooth streaming.
- Wired beats Wi-Fi, the single biggest difference when gaming.
- Close heavy tabs before opening the viewer.
- Running several viewers at once? Give your computer 8GB of RAM or more.