Start here when Better xCloud stops working
Write down the exact symptom
Record whether the menu is missing, the game fails to launch, the stream is black, a setting throws an error or an input device disappears.
Undo the last change
If the issue started after changing a setting, return to the previous value or reload with the default profile before trying another fix.
Reload the correct client
Refresh Xbox Cloud Gaming, restart the Android app or reopen Safari after confirming that the userscript or extension is enabled.
Test without duplicate layers
Disable an old Better xCloud extension, second userscript manager or conflicting input remapper if more than one client layer is active.
If Better xCloud is not showing up
On PC, open your userscript manager and confirm that Better xCloud is enabled for the Xbox Cloud Gaming domain. Check the active browser profile, private-window permissions and extension site access. A script can be installed but never execute if the manager is not allowed to run on the page.
On iOS, check the Safari helper's website permissions and reload the tab. On Android, open the Better xCloud app directly rather than looking for a browser userscript menu. On TV platforms, follow the platform-specific route instead of copying desktop steps.
- Confirm the page URL is the Xbox Cloud Gaming page you intended to use.
- Check that the script or app version matches the platform.
- Disable duplicate Better xCloud installations temporarily.
- Reload after changing permissions or developer-mode settings.
- Try a clean browser profile only after recording the original error.
If a game no longer launches
A game that stopped launching after a Better xCloud change may be hitting an unsupported setting, stale page state, a release regression or a normal Xbox Cloud Gaming availability issue. Revert the last client change, reload the page and try a different supported game before concluding that the entire installation is broken.
Do not keep clicking a failing launch button while changing server, resolution and input settings at the same time. That makes the error harder to reproduce and can leave the browser with multiple stale sessions.
One game fails
Compare another game. If only one title fails, the issue may be game-specific or service-side rather than a broken installation.
Every game fails
Check the client layer, login state, browser permissions, app version and the official upstream troubleshooting notes.
Black screen or frozen stream
Return to default resolution and bitrate, then inspect decoder performance and network stability.
Useful error-state checks
| Symptom or message | First check | Next step |
|---|---|---|
| Failed to run Better xCloud | Userscript manager and browser permissions | Reload, remove duplicates and compare the official release |
| Content Script API | Extension/API mode and browser support | Use the upstream troubleshooting page and current browser route |
| UserScript API Dynamic | Userscript manager version or page access | Update the manager, verify permissions and test a clean profile |
| Game does not launch | Last setting change and service login | Revert, reload and test another game |
| Controller not visible | OS pairing and browser input permissions | Open the controller guide and remove virtual-controller conflicts |
Official troubleshooting references
When an error string changes after a new release, use the upstream page and repository issue tracker for the current diagnosis.
Better xCloud not working fixes: recovery sequence
When the note says "Better xCloud not working," use a recovery sequence that moves from the smallest, most reversible check to the largest change. Start by recording the exact symptom and the last setting you changed. Reload the existing client, remove duplicate userscript or extension layers and test the default profile. Only after that should you compare another browser, device or game.
This approach protects the evidence that can explain the failure. Reinstalling immediately may remove a useful error message, while changing server, resolution, bitrate and input mode together creates several possible causes. If the problem returns after one specific change, keep that setting documented and compare the upstream release notes or issue tracker before treating it as a universal bug.
Capture the state
Write down the route, platform, version, browser or app, game and visible error.
Revert the last change
Return to the previous setting or default profile and reload the client.
Remove duplicate layers
Disable extra userscript managers, old extensions, remappers or virtual controllers.
Compare one control
Test another game or browser while keeping the network and device unchanged.
Use the upstream source
Check current documentation and release issues before installing a different file.
Separate client, network and game failures
If the Better xCloud menu is missing, focus on the userscript, extension, app or Safari permission layer. If the menu is visible but the stream is black or stutters, compare default resolution, bitrate, decoding and network behavior. If only one game fails while other titles launch, treat the result as a game or service-specific signal until another test proves otherwise.
A useful troubleshooting note includes both a positive and a negative comparison: for example, the controller works in the operating system but not in the browser, or another game launches in the same client while one title does not. These comparisons reduce guesswork and make an upstream issue report more actionable.
- Client failure: no menu, missing controls or an execution error.
- Input failure: the OS sees a device but the browser, app or game does not.
- Stream failure: black screen, stutter, decoding pressure or packet loss.
- Game failure: one title fails while another title works in the same session.
- Service failure: multiple clients and games show the same availability symptom.
Better xCloud troubleshooting FAQ
Why does Better xCloud show an error after I change one setting?
The changed option may be unsupported in the current client, conflict with another setting or expose a browser/userscript issue. Revert the last change and test one variable at a time.
Why is the Better xCloud menu missing?
Check userscript or extension permissions, the current Xbox Cloud Gaming URL, duplicate installations and whether the correct platform client is running.
Why does Better xCloud launch but the game stays black?
Return to default resolution and bitrate, check decoding performance and network stability, then compare another game or browser/device.
Should I reinstall Better xCloud first?
Usually no. Record the error, revert the last change, check permissions and remove duplicates first. Reinstallation can hide the original cause.
Why can I see the controller in the OS but not in Better xCloud?
The browser, app or game may not receive the device even when the operating system does. Check browser permissions, virtual-controller conflicts and the game input mode.
Is Better xCloud down?
A local client error, Xbox Cloud Gaming service issue and a single-game problem can look similar. Compare another game, another client and the official upstream status or issue reports before deciding.
What should I do when Better xCloud is not working after an update?
Record the new version, revert any changed setting, disable duplicate layers and compare the official release notes. Do not mix an old userscript with a new extension while diagnosing.
How do I know whether the network or Better xCloud is the problem?
Compare the same client with default settings, another game and a stable network path. If the menu works but the stream changes with packet loss or jitter, investigate the connection separately from the userscript.
What does "Better xCloud not working" usually mean?
It can mean a missing userscript menu, a launch error, a black stream, an input failure or a network symptom. Record which layer fails before choosing a fix.