Skip to content

defa1lt/Better-xCloud-iOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 

Repository files navigation

Better xCloud for iOS (Unofficial)

An unofficial iOS wrapper for Xbox Cloud Gaming (xCloud) that bundles the Better xCloud userscript for a smoother, more console-like experience on iPhone and iPad.

Important

Disclaimer: This project is not affiliated with, endorsed by, or sponsored by Microsoft or Xbox. “Xbox,” “xCloud,” and related marks are trademarks of their respective owners. Use at your own risk.

iOS 15+ Wrapper Binary only

Links


Why use the iOS app instead of Safari?

  • ✅ All features of the Better xCloud userscript (auto-injected)
  • ✅ True fullscreen, safe areas ignored
  • ✅ Xbox-style preloader (logo + progress bar)
  • ✅ Prevents accidental pinch-to-zoom and hides scroll indicators
  • ✅ Swipe-to-go-back works like Safari; bottom system gestures are deferred
  • ✅ Inline media playback; no forced taps for video/audio
  • ✅ Built-in JS/console error logger to help troubleshoot
  • ✅ Small, fast, battery-friendly wrapper

The app doesn’t modify Microsoft’s servers. It loads xbox.com/play and enhances it client-side using the userscript.


Download & Install

Binary-only distribution. Get the latest .ipa from this repository’s Releases page.

Option A — AltStore (recommended, free)
  1. Install AltServer on macOS/Windows.
  2. Connect your device and install AltStore.
  3. On iPhone/iPad: AltStore → My Apps → + → select the downloaded .ipa.
  4. If prompted, trust the developer profile in Settings → General → VPN & Device Management.
Option B — Sideloadly (Windows/macOS)
  1. Open Sideloadly, connect your device.
  2. Drag the .ipa in, sign with your Apple ID, and install.

Note

Free Apple IDs require re-signing about every 7 days. A paid Developer account lasts up to 12 months per build.


Requirements

  • iOS/iPadOS 15.0+
  • An active Xbox Cloud Gaming–supported account/region
  • Stable internet (5 GHz Wi-Fi recommended; wired gamepad support varies by device)

Features (iOS specifics)

  • Preloader waits for actual UI readiness (region button / video surface)
  • Disables zoom (meta + CSS + gesture blocking) while keeping Safari-style back swipe
  • Hides all scroll indicators (WebView + in-page elements)
  • Defers bottom system gestures and auto-hides Home indicator
  • Bundled polyfills for navigator.mediaDevices.* to avoid site crashes
  • Opens target="_blank" in the same view (PWA-like)
  • JS dialogs (alert/confirm/prompt) handled natively (e.g., “Quit game” confirm)

Privacy

  • The app does not collect analytics or personal data.
  • Network traffic goes to Microsoft’s Xbox Cloud Gaming domains as part of normal site usage.
  • Any telemetry you see in the console (e.g., Application Insights) belongs to Microsoft’s site, not this app.

Known Limitations

  • Feature availability depends on Microsoft’s site and your region.
  • If Microsoft changes the site, some enhancements may temporarily break until the userscript is updated.
  • On free certificates (sideloading), the app must be re-signed periodically.

Troubleshooting

  • Stuck on loading: Kill the app and relaunch; ensure network is stable.
  • “Script error” with no stack: Cross-origin protection in WKWebView; harmless and normal for third-party bundles.
  • No region button / blank UI: Wait a few seconds; the preloader hides only when the UI is visible. If it persists, try reloading or signing out/in on xbox.com/play.
  • Gamepad issues: Reconnect the controller; if using Bluetooth, toggle it off/on.

Credits


Legal

This project is provided “as is,” without warranty of any kind. By using this app you agree you are responsible for your account and device. Microsoft/Xbox are trademarks of Microsoft Corporation. This app is not affiliated with or endorsed by Microsoft.


License

  • App binary: Distributed without source; all rights reserved by the distributor.
  • Userscript: See its repository for license and terms.

If you find this useful, consider ⭐ starring the Better xCloud userscript repo or supporting its author.

About

IOS app to improve Xbox Cloud Gaming (xCloud)

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors