mirror of
https://github.com/redphx/better-xcloud.git
synced 2025-06-28 18:31:44 +02:00
Compare commits
165 Commits
Author | SHA1 | Date | |
---|---|---|---|
0870065a81 | |||
e0f0617b12 | |||
38623cc086 | |||
bbce49791f | |||
d719f0c2b5 | |||
622057980d | |||
24d608bc3e | |||
f55344b4cb | |||
6139fb386b | |||
f7c46c5ef3 | |||
f5b495efa8 | |||
eb4803492e | |||
47ef7da37b | |||
63896469e2 | |||
4ab265e370 | |||
584509a53d | |||
f3b9ebdb22 | |||
abd1aae57a | |||
ccdb944b99 | |||
b4149e718b | |||
7c22685e95 | |||
ad98eb60e1 | |||
049e65429a | |||
a5b77ae8c0 | |||
49550eed0a | |||
01861e0ca5 | |||
12d6fbd9c8 | |||
1b0b15de76 | |||
5eba0f0ed7 | |||
0a851e5417 | |||
d38e5e8812 | |||
69261a7f1d | |||
96b20dcb19 | |||
c5a4af9f49 | |||
3c62d1356f | |||
78bfc09749 | |||
f3bf7a0230 | |||
c9a2d92c47 | |||
5f18026f85 | |||
f4c299e730 | |||
baf7893769 | |||
26ef306bab | |||
dc55b85772 | |||
bec3f771f2 | |||
7dc35a09c4 | |||
b72b881f2d | |||
4748d72d59 | |||
95d4216824 | |||
a0a453084a | |||
9b84690328 | |||
1ffe5c218a | |||
1ea5f5031e | |||
526ceec0db | |||
d54c3d50c4 | |||
f306cb5eee | |||
c1acb689fe | |||
5837e30afc | |||
9b955aabb9 | |||
d73f91ed5f | |||
b918fadaab | |||
b79775839b | |||
d3e0ba9d9f | |||
e6e8297632 | |||
e94fb28266 | |||
11e953c382 | |||
4845ea6994 | |||
0f0072bcb0 | |||
85d156f6b2 | |||
8d24494b02 | |||
9d1bca99aa | |||
a8cf0896c5 | |||
4767df442e | |||
8314074957 | |||
6ffa75a4ec | |||
7813e6f432 | |||
75d9639c01 | |||
fb80c3662a | |||
9e1d8866ce | |||
28438c7c9e | |||
0cb0901ae2 | |||
9d7c537eaa | |||
eccd306d03 | |||
e15afd2396 | |||
f0dbc72987 | |||
25bf6c209d | |||
f229dbdbe4 | |||
e845c902b2 | |||
c424c6f94b | |||
1619fb2b26 | |||
d72641ba77 | |||
7c3f00f277 | |||
9bd0ee9097 | |||
a9bb977311 | |||
3e0653fadf | |||
36f6b04ad9 | |||
60b70e259b | |||
c50e0d6aff | |||
a3fd3c9ebe | |||
c47caea65e | |||
6f540cca7a | |||
7a202ba8a7 | |||
1f787b7888 | |||
0cc96135c9 | |||
ed2fb13e17 | |||
b91474c20b | |||
18eec8b8da | |||
949a180047 | |||
c9a67cf6b7 | |||
b469ba4867 | |||
a0d0d6e1e6 | |||
cc466ff2ac | |||
b1bfe96935 | |||
241be49d09 | |||
7c48b7e6fb | |||
cc9a644a5e | |||
a77db68afb | |||
cd7a7c92c7 | |||
651402a6b4 | |||
6cd2648325 | |||
fa0d761d24 | |||
f01d7a3b0b | |||
b520e8173e | |||
f15f43faf7 | |||
e470cb20a3 | |||
d1882046e2 | |||
fb7bd2da0d | |||
d9a14f9d83 | |||
18dd006aad | |||
f74de11e10 | |||
2a71e17d2d | |||
2a85dd574e | |||
9692286f1e | |||
26498efa7c | |||
d1c724ff2c | |||
eec41c58b6 | |||
38cc78e0da | |||
3cf029818e | |||
5104cf33b4 | |||
771111d1f8 | |||
79e0661977 | |||
2dc3097737 | |||
0833afc0a2 | |||
ca8b3cfbd8 | |||
bd852c788d | |||
3a82b74cda | |||
dce0a44d2a | |||
1d0d69850f | |||
e719e6e1c5 | |||
9f3c6e5a6d | |||
b6e1d3debc | |||
c229cf7c47 | |||
343e243c77 | |||
0722e02ab0 | |||
c520fde438 | |||
2f4396d948 | |||
88d46581bf | |||
0cd6106957 | |||
43b932f5d6 | |||
8315cee7ec | |||
9d6db3ed37 | |||
e85fc9aa47 | |||
2d680d63a1 | |||
aefd9e9320 | |||
ecaead1522 | |||
f71152595f |
1
.github/FUNDING.yml
vendored
Normal file
1
.github/FUNDING.yml
vendored
Normal file
@ -0,0 +1 @@
|
||||
ko_fi: redphx
|
12
.github/ISSUE_TEMPLATE/bug_report.md
vendored
12
.github/ISSUE_TEMPLATE/bug_report.md
vendored
@ -1,18 +1,18 @@
|
||||
---
|
||||
name: Bug report
|
||||
about: Create a report to help us improve
|
||||
title: "[Bug]"
|
||||
title: "[Bug] ..."
|
||||
labels: bug
|
||||
assignees: ''
|
||||
|
||||
---
|
||||
|
||||
**Platform**
|
||||
- Device: [e.g. Phone, Laptop, Desktop, TV]
|
||||
- OS: [e.g. Windows, Android, iOS]
|
||||
- Browser: [e.g. Chrome, Kiwi]
|
||||
- Browser Version: [e.g. 100]
|
||||
- Better xCloud Version: [e.g. 1.4]
|
||||
- Device: Phone, Laptop, Desktop, TV...
|
||||
- OS: Windows, Android, iOS...
|
||||
- Browser: Chrome, Safari, Kiwi...
|
||||
- Browser Version:
|
||||
- Better xCloud Version:
|
||||
|
||||
**Describe the bug**
|
||||
...
|
||||
|
2
.github/ISSUE_TEMPLATE/feature_request.md
vendored
2
.github/ISSUE_TEMPLATE/feature_request.md
vendored
@ -1,7 +1,7 @@
|
||||
---
|
||||
name: Feature request
|
||||
about: Suggest an idea for this project
|
||||
title: "[Feature]"
|
||||
title: "[Feature] ..."
|
||||
labels: enhancement
|
||||
assignees: ''
|
||||
|
||||
|
284
README.md
284
README.md
@ -1,74 +1,170 @@
|
||||
# Better xCloud
|
||||
Improve [Xbox Cloud Gaming (xCloud)](https://www.xbox.com/play/) experience on web browser.
|
||||
The main target of this script is mobile users, but it should work great on desktop too.
|
||||
Improve Xbox Cloud Gaming (xCloud) experience on [xbox.com/play](https://www.xbox.com/play). It also allows you to use Remote Play on the xCloud website.
|
||||
|
||||
**Supported platforms:**
|
||||
- Windows
|
||||
- macOS
|
||||
- Linux, SteamOS (Steam Deck)
|
||||
- Android, Android TV
|
||||
- iOS, iPadOS
|
||||
|
||||
This script makes me spend more time with xCloud, and I hope the same thing happens to you.
|
||||
Give this project a 🌟 if you like it. Thank you 🙏.
|
||||
If you like this project please give it a 🌟. Thank you 🙏.
|
||||
|
||||
[](https://github.com/redphx/better-xcloud/releases)
|
||||
[](https://github.com/redphx/better-xcloud/stargazers)
|
||||
<!--
|
||||
[](https://github.com/redphx/better-xcloud/releases)
|
||||
-->
|
||||
[](https://github.com/redphx/better-xcloud/stargazers)
|
||||
|
||||
|
||||
## Table of Contents
|
||||
- [**How to install**](#how-to-install)
|
||||
- [**Compatibility**](#compatibility)
|
||||
- [**Features**](#features)
|
||||
- [**Stream stats**](#stream-stats)
|
||||
- [**Capture screenshot**](#capture-screenshot)
|
||||
- [**FAQ**](#faq)
|
||||
- [**Translators**](#translators)
|
||||
- [**Donation**](#donation)
|
||||
- [**Acknowledgements**](#acknowledgements)
|
||||
- [**Disclaimers**](#disclaimers)
|
||||
|
||||
## How to install
|
||||
1. Install an userscript extension:
|
||||
- **Safari**: Install [Userscripts extension](https://apps.apple.com/us/app/userscripts/id1463298887). Check [this page](https://github.com/redphx/better-xcloud/wiki/Using-with-Safari) before using.
|
||||
- **All other browsers**: Install [Tampermonkey extension](https://www.tampermonkey.net/).
|
||||
3. Install **Better xCloud**:
|
||||
- [Stable version](https://github.com/redphx/better-xcloud/releases/latest/download/better-xcloud.user.js)
|
||||
<!-- - [Dev version](https://github.com/redphx/better-xcloud/raw/main/better-xcloud.user.js)-->
|
||||
I only distribute **Better xCloud** on GitHub, *DO NOT* download it on other websites or from unknown sources.
|
||||
4. Refresh the [xCloud web page](https://www.xbox.com/play/).
|
||||
5. Click on the new *\<SERVER NAME\>* button next to your profile picture to adjust settings.
|
||||
|
||||
To update manually, just install the script again (you won't lose your settings).
|
||||
|
||||
⚠️⚠️⚠️ If you're using Kiwi Browser on Android, make sure to follow the steps correctly and install the script with Tampermonkey (not installing it as an extension), or else it won't work.
|
||||
|
||||
## Compatibility
|
||||
- 👍 = best choice, all features work as intended
|
||||
- ✅ = confirmed to be working, might miss some features
|
||||
- ❌ = not supported (mostly because of lacking Userscript/extension support)
|
||||
- ➖ = unavailable
|
||||
- 🗒️ = see custom notes
|
||||
|
||||
| | Windows/Linux/SteamOS | macOS | Android/Android TV | iOS |
|
||||
|-----------------------------------------|:----------------------|:-----------------|:-------------------|:-----------------|
|
||||
| Chrome/Edge/Chromium... | 👍 | 👍 | ❌ | ❌ |
|
||||
| Firefox | ✅ | ✅ | 🗒️<sup>(1)</sup> | ❌ |
|
||||
| Safari | ➖ | ✅<sup>(2)</sup> | ➖ | ✅<sup>(3)</sup> |
|
||||
| [Kiwi Browser](https://kiwibrowser.com) | ➖ | ➖ | 👍 | ➖ |
|
||||
|
||||
Don't see your browser in the table? If it supports Tampermonkey/Userscript then the answer is likely **"YES"**.
|
||||
|
||||
<sup>1</sup> Follow [this guide](https://support.mozilla.org/en-US/kb/find-and-install-add-ons-firefox-android) to install Tampermonkey on Firefox Android. Its Gamepad API doesn't work properly so it might not recognize your controller.
|
||||
<sup>2, 3</sup> Requires [Userscripts app](https://apps.apple.com/us/app/userscripts/id1463298887) (free & open-source). Check [this page](https://github.com/redphx/better-xcloud/wiki/Using-with-Safari) before using.
|
||||
|
||||
---
|
||||
- **Kiwi Browser** is the best choice on Android. All features work, it means you can get 1080p stream + high-quality codec profile (the best possible quality).
|
||||
- **Better xCloud** also works on Android TV, but you'll have to sideload the browser APK and need a Bluetooth mouse if you want to interact with the Settings.
|
||||
|
||||
## Features
|
||||
|
||||
<img width="400" alt="Settings UI" src="https://github.com/redphx/better-xcloud/assets/96280/6e74fdaf-dc84-416a-a2bc-5e117a3717e3">
|
||||
<img width="400" alt="Settings UI" src="https://github.com/redphx/better-xcloud/assets/96280/ca38b3fa-1e89-4b37-937c-a6796c07cdf1">
|
||||
<br>
|
||||
<img width="600" alt="Stream HUD" src="https://github.com/redphx/better-xcloud/assets/96280/e30f6514-13ca-41c6-bff2-979573cff956">
|
||||
<img width="400" alt="Remote Play dialog" src="https://github.com/redphx/better-xcloud/assets/96280/daf7f698-a228-4f9c-8f23-9669e061a64c">
|
||||
<br>
|
||||
<img width="600" alt="Video settings" src="https://github.com/redphx/better-xcloud/assets/96280/c45877f9-379c-4ba4-977c-021d3d8835e4">
|
||||
<img width="600" alt="Stream HUD" src="https://github.com/redphx/better-xcloud/assets/96280/51bdb96c-79ab-402f-902a-a9e6229973b2">
|
||||
<br>
|
||||
<img width="600" alt="Stream settings" src="https://github.com/redphx/better-xcloud/assets/96280/ed513cb3-6e6c-4e8e-9e06-c62e71e41c90">
|
||||
|
||||
|
||||
|
||||
**Demo video:** [https://youtu.be/oDr5Eddp55E ](https://youtu.be/AYb-EUcz72U)
|
||||
|
||||
- **🔥 Support [Remote Play](https://support.xbox.com/help/games-apps/game-setup-and-play/how-to-set-up-remote-play)**
|
||||
> 1080p resolution and can stream Xbox 360 games.
|
||||
- **🔥 Improve visual quality of the stream**
|
||||
> Similar to (but not as good as) the "Clarity Boost" of xCloud on Edge browser. [Demo video](https://youtu.be/ZhW2choAHUs).
|
||||
- **🔥 Show stream stats**
|
||||
> Check [Stream stats section](#stream-stats) for more info.
|
||||
- **🔥 Capture screenshot**
|
||||
> Exclusive to **Better xCloud**. Check the [**Capture screenshot** section](#capture-screenshot) for more info.
|
||||
- **🔥 Hold the "Quit game" button for one second to refresh the stream**
|
||||
> Sometimes you can fix the bad connection to the stream simply by refreshing the page.
|
||||
> Sometimes you can fix the bad connection to the stream or low FPS simply by refreshing the page.
|
||||
> Useful on mobile where the pull-to-refresh feature doesn't work while playing.
|
||||
- **🔥 Touch controller**
|
||||
> Enable touch controller support for all games.
|
||||
|
||||
### Server
|
||||
- **Set the region of streaming server**
|
||||
> Connect to another server instead of the default one. Check the [**FAQ** section](#faq) for some notes.
|
||||
> Connect to another server instead of the default one.
|
||||
> It's not using VPN.
|
||||
> ["Can I get banned for using this?"](#faq)
|
||||
- **Preferred game's language**
|
||||
> If the game doesn't support this language, it will use the same language as xCloud's website.
|
||||
- **Prefer IPv6 server**
|
||||
> Might reduce latency.
|
||||
|
||||
### Stream quality
|
||||
### Stream
|
||||
- **Set target resolution**
|
||||
> By default you only get 1080p stream when playing on desktop.
|
||||
> This feature can give you 1080p stream even on mobile, without having to change User-Agent.
|
||||
- **Force high-quality codec (if supported)<sup>(\*)</sup>**
|
||||
> Force xCloud to use the best streaming codec profile (same as desktop & TV) if possible. You don't have to change User-Agent anymore.
|
||||
> You should enable this feature even if you're on desktop.
|
||||
> Not available for some browsers (Firefox, Safari...).
|
||||
> Use more bandwidth & battery.
|
||||
- **Change visual quality**
|
||||
> Increase/decrease the quality of the stream to your liking. Only works in Chrome/Edge/Kiwi...
|
||||
> Comparison video with the setting ON & OFF: https://youtu.be/-9PuBJJSgR4
|
||||
- **Disable bandwidth checking**
|
||||
> xCloud won't warn about slow connection speed.
|
||||
|
||||
### Controller
|
||||
- **🔥 Touch controller**
|
||||
> Only for mobile (Android/iOS/iPadOS).
|
||||
> - **Default**: nothing change.
|
||||
> - **Off**: stop the touch controller from showing when touching the screen. Useful when you play on a device with a built-in controller like Logitech G Cloud, Steam Deck, etc.
|
||||
> - **All games**: enable touch controller support for all games. Games with custom layout won't be affected.
|
||||
> Double-tap anywhere at the bottom of the screen to show/hide the controller. Useful when you're viewing cutscenes.
|
||||
> 
|
||||
|
||||
> xCloud won't warn about slow connection speed.
|
||||
- **Enable volume control feature**
|
||||
> Allow increasing stream's volume up to 600%
|
||||
> ⚠️ Disable this setting if you experience slowdown, choppy/muted stream
|
||||
- **Enable microphone on game launch**
|
||||
> Automatically enable the mic when starting to play a game.
|
||||
- **Hide mouse cursor on idle**
|
||||
> Hide the mouse cursor after 3 seconds of not moving.
|
||||
|
||||
### Controller
|
||||
- Enable controller shortcuts
|
||||
> `Home` is the button which activates the Xbox sidebar menu (similar to the Xbox/Nexus button on the official controller).
|
||||
> Not all controllers have this button. It's the `B16` button on the [Gamepad Tester site](https://hardwaretester.com/gamepad).
|
||||
> More shortcuts will be added later.
|
||||
|
||||
| Shortcut | Action |
|
||||
|---------------|------------------|
|
||||
| Home + RB | Take screenshot |
|
||||
| Home + Select | Toggle stats bar |
|
||||
|
||||
### 🔥 Touch controller
|
||||
- **Availability**
|
||||
> Only for devices with touch support (Android/iOS/iPadOS/...). Using "Desktop mode" in mobile browsers also disables this feature.
|
||||
> - **Default**: nothing change.
|
||||
> - **Off**: stop the touch controller from showing when touching the screen. Useful when you play on a device with a built-in controller like Logitech G Cloud, Steam Deck, etc.
|
||||
> - **All games**: enable touch controller support for all games. Games with custom layout won't be affected.
|
||||
> Double-tap anywhere at the bottom of the screen to show/hide the controller. Useful when you're viewing cutscenes.
|
||||
>
|
||||
> 
|
||||
- **Button styles**
|
||||
> - Default
|
||||
> - Muted
|
||||
> - All white (only for standard/default controller)
|
||||
>
|
||||
> <img width="400" alt="Button styles" src="https://github.com/redphx/better-xcloud/assets/96280/2bfef2b3-6712-4924-b067-c2312f8c8062">
|
||||
|
||||
### Loading screen
|
||||
- **Show game art**
|
||||
> Replace the black background with game art if it's available.
|
||||
- **Show the estimated wait time**
|
||||
> The time is estimated by the server.
|
||||
> It's not 100% correct: you might get in the game sooner or later.
|
||||
> Check [#51](https://github.com/redphx/better-xcloud/issues/51) for more info.
|
||||
- **Show/hide the rocket animation**
|
||||
> Always show/Hide when queuing/Always hide.
|
||||
> Hide this animation might save some battery life while queuing.
|
||||
|
||||
<img height="300" alt="Loading screen" src="https://github.com/redphx/better-xcloud/assets/96280/46074b14-1abb-466d-a859-d46ad4dac2fd">
|
||||
|
||||
|
||||
### UI
|
||||
- **Simplify Stream's menu**
|
||||
- **Switch website's layout**
|
||||
> Switch between default layout and Smart TV layout (without having to change User-Agent).
|
||||
- **Simplify Stream's menu**
|
||||
> Hide the labels of the menu buttons.
|
||||
- **Skip Xbox splash video**
|
||||
> Save 3 seconds.
|
||||
@ -83,13 +179,28 @@ Give this project a 🌟 if you like it. Thank you 🙏.
|
||||
- **Disable xCloud analytics**
|
||||
> The analytics contains statistics of your streaming session, so I'd recommend allowing analytics to help Xbox improve xCloud's experience in the future.
|
||||
|
||||
### Stream's video features
|
||||
⚠️ These features don't work when xCloud's "Clarity Boost" feature is ON ([#64](https://github.com/redphx/better-xcloud/issues/64)).
|
||||
### In-game settings
|
||||
- **🔥 Controller & device vibrations**
|
||||
> Control vibration settings
|
||||
> Adjust vibration intensity
|
||||
- **Volume control**
|
||||
> Increase stream's volume up to 600%
|
||||
> Can be disabled in the Main Settings
|
||||
- **🔥 Improve stream's clarity**
|
||||
> Similar to (but not as good as) the "Clarity Boost" of xCloud on Edge browser. [Demo video](https://youtu.be/ZhW2choAHUs).
|
||||
> Also known as poor man's "Clarity Boost".
|
||||
> Affects the stream's performance, uses more battery, and may causes frames to drop (especially on lower-end devices).
|
||||
> Works with Chrome/Chromium browsers.
|
||||
> Doesn't work with Safari.
|
||||
>
|
||||
> 
|
||||
> *(click to enlarge)*
|
||||
|
||||
- **Stretch video to full sctreen**
|
||||
- **Change video's ratio**
|
||||
> Useful when you don't have a 16:9 screen
|
||||
- **Adjust video filters**
|
||||
> Brightness/Contrast/Saturation.
|
||||
> Brightness/Contrast/Saturation.
|
||||
> ⚠️ These features don't work when xCloud's "Clarity Boost" feature is ON ([#64](https://github.com/redphx/better-xcloud/issues/64)).
|
||||
- **Display stream's statuses**
|
||||
> Region/Server/Codecs/Resolution...
|
||||
> Current playtime of the session.
|
||||
@ -105,65 +216,25 @@ Give this project a 🌟 if you like it. Thank you 🙏.
|
||||
|
||||
<sup>(\*)</sup> By default (for compatibility reasons) xCloud only uses high quality codec profile when you use Tizen TV or Chrome/Edge/Chromium browser on Chrome/MacOS. Enable this setting will give you the best experience no matter what platform & browser you're on.
|
||||
|
||||
## How to use
|
||||
1. Install [Tampermonkey extension](https://www.tampermonkey.net/) on suppported browsers. For Safari, use [Userscripts app](https://apps.apple.com/us/app/userscripts/id1463298887).
|
||||
2. Install **Better xCloud**:
|
||||
- [Stable version](https://github.com/redphx/better-xcloud/releases/latest/download/better-xcloud.user.js)
|
||||
- [Dev version](https://github.com/redphx/better-xcloud/raw/main/better-xcloud.user.js)
|
||||
I only distribute **Better xCloud** on GitHub, *DO NOT* download it on other websites or from unknown sources.
|
||||
3. Refresh [xCloud web page](https://www.xbox.com/play/).
|
||||
4. Click on the new "SERVER NAME" button next to your profile picture to adjust settings.
|
||||
5. Don't forget to enable auto updating for the script in Tampermonkey.
|
||||
|
||||
To update manually, just install the script again (you won't lose your settings).
|
||||
|
||||
## Tutorial videos
|
||||
If you still have trouble installing **Better xCloud**, you can follow one of these tutorial videos:
|
||||
- 🇧🇷 [Tudo isso agora tem no xCloud!! (ChipTec)](https://youtu.be/zS8Zy0mYIbU?t=40)
|
||||
- 🇫🇷 [#Tuto Xbox Cloud Gaming : Ecran ultra large et adieu les bandes noires sur smartphone (Cloud Gaming France)](https://www.youtube.com/watch?v=5U05KoTdDHs)
|
||||
|
||||
|
||||
## Compatibility
|
||||
✅ = confirmed to be working
|
||||
❓ = not yet tested
|
||||
❌ = not supported (mostly because of lacking Userscript/extension support)
|
||||
➖ = unavailable
|
||||
⚠️ = see custom notes
|
||||
| | Desktop | Android/Android TV | iOS |
|
||||
|-----------------------------------------|:-----------------|:-------------------|:----------------|
|
||||
| Chrome/Edge/Chromium variants | ✅ | ❌ | ❌ |
|
||||
| Firefox | ✅ | ⚠️<sup>(1)</sup> | ❌ |
|
||||
| Safari | ✅<sup>(2)</sup> | ➖ | ✅<sup>(3)</sup> |
|
||||
| [Hermit](https://hermit.chimbori.com) | ➖ | ⚠️<sup>(4)</sup> | ➖ |
|
||||
| [Kiwi Browser](https://kiwibrowser.com) | ➖ | ✅ | ➖ |
|
||||
|
||||
Don't see your browser in the table? If it supports Tampermonkey/Userscript then the answer is likely **"YES"**.
|
||||
|
||||
<sup>1</sup> Follow [this guide](https://support.mozilla.org/en-US/kb/find-and-install-add-ons-firefox-android) to install Tampermonkey on Firefox Android. Its Gamepad API doesn't work properly so it might not recognize your controller.
|
||||
<sup>2, 3</sup> Requires [Userscripts app](https://apps.apple.com/us/app/userscripts/id1463298887) (free & open source).
|
||||
<sup>4</sup> NOT RECOMMENDED at the moment since its Userscript implementation is not working properly (see https://github.com/redphx/better-xcloud/issues/5 for full details).
|
||||
|
||||
---
|
||||
- **Kiwi Browser** is the best choice on Android. All features work, it means you can get 1080p stream + high quality codec profile (the best possible quality).
|
||||
- **Better xCloud** also works on Android TV, but you'll have to sideload the browser APK and need a Bluetooth mouse if you want to interact with the Settings.
|
||||
|
||||
## Stream stats
|
||||
<img width="500" alt="Stream stats" src="https://github.com/redphx/better-xcloud/assets/96280/0d4abb6b-49ab-4c9a-a52d-df7e396d2145">
|
||||
<img alt="Stream stats" src="https://github.com/redphx/better-xcloud/assets/96280/9fb51941-85a9-47c4-8d48-331456b9ce73">
|
||||
|
||||
<img width="418" alt="Stream stats settings" src="https://github.com/redphx/better-xcloud/assets/96280/6313a0c6-03bf-4325-b60d-18a23c681933">
|
||||
|
||||
- While playing > `...` > `Stream Stats`.
|
||||
- Double-click on the stats bar to show the Settings dialog.
|
||||
- While playing > `...` > `Stream Stats`.
|
||||
- Change settings by opening `Stream settings` while playing.
|
||||
- This bar is updated every second.
|
||||
- **Quick glance** feature: only show the stats bar when the System menu is expanded. The 👀 emoji at the beginning indicates that the stats bar is in the quick glance mode.
|
||||
- ⚠️ Using **Better xCloud** or showing the stats bar also affects the performance of the stream.
|
||||
|
||||
| Abbr. | Full name | Explain |
|
||||
|------:|:-------------------|:-------------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| FPS | Frames per Seconds | The number of decoded frames in the last second of the stream (may not be the same as the FPS of the game) |
|
||||
| DT | Decode Time | The average time it took to decode one frame in the last second (bugged in Kiwi Browser [#26](https://github.com/redphx/better-xcloud/issues/26)) |
|
||||
| RTT | Round Trip Time | The number of seconds it takes for data to be sent from your device to the server and back over (similar to ping, lower is better) |
|
||||
| BR | Bitrate | The amount of data the server sent to your device in the last second |
|
||||
| PL | Packets Lost | The total number of packets lost |
|
||||
| FL | Frames Lost | The total number of frames dropped prior to decode or dropped because the frame missed its display deadline |
|
||||
| Abbr. | Full name | Explain |
|
||||
|------:|:-------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| PING | Ping | The number of seconds it takes for data to be sent from your device to the server and back over (the correct term is "Round Trip Time") |
|
||||
| FPS | Frames per Seconds | The number of decoded frames in the last second of the stream (may not be the same as the FPS of the game) |
|
||||
| DT | Decode Time | The average time it took to decode one frame in the last second (bugged on Android [#26](https://github.com/redphx/better-xcloud/issues/26)) |
|
||||
| BR | Bitrate | The amount of data the server sent to your device in the last second |
|
||||
| PL | Packets Lost | The total number of packets lost |
|
||||
| FL | Frames Lost | The total number of frames dropped prior to decode or dropped because the frame missed its display deadline |
|
||||
|
||||
This info is provided by WebRTC API. You can use browser's built-in tool to see more info:
|
||||
- Chrome/Edge/Chromium variants: `chrome://webrtc-internals`
|
||||
@ -195,7 +266,7 @@ Colors:
|
||||
5. Screenshot will be saved by the browser.
|
||||
6. You can double-tap that corner to capture screenshot.
|
||||
|
||||
<img width="600" alt="Screenshot button" src="https://github.com/redphx/better-xcloud/assets/96280/a911b141-5dc0-450a-aeac-30d9cf202b44">
|
||||

|
||||
|
||||
## FAQ
|
||||
1. **Will I get banned for using this?**
|
||||
@ -205,27 +276,50 @@ I think it's very unlikely that you'll get banned for using this. Most of the fe
|
||||
It's because not many browsers on Android support installing extensions (and not all extensions can be installed).
|
||||
|
||||
3. **Why doesn't the xCloud website implement *this* or *that* feature from Better xCloud?**
|
||||
For being an unofficial tool, **Better xCloud** has the luxury to implement anything on the xCloud website. On the xCloud's side, they have a lot more users and devices to support, so it's more difficult for them to implement a new feature. Also it's not easy to explain some of the features of **Better xCloud** to normal xCloud users.
|
||||
Think of this project as an unofficial beta version of xCloud.
|
||||
- **Better xCloud** doesn't have to worry about the compatibility much: if it doesn't work on this browser, it can just suggest you switch to another one. xCloud can't do the same.
|
||||
- On the xCloud's side, they have a lot more users and devices to support, so it's more difficult for them to implement a new feature.
|
||||
- Also, it's not easy to explain some of the features of **Better xCloud** to normal xCloud users.
|
||||
|
||||
4. **Can I use this with the Xbox Android app?**
|
||||
No, you can't. You'll have to modify the app.
|
||||
|
||||
5. **Will it be able to enable the "Clarity Boost" feature on non-Edge browsers?**
|
||||
No. The "Clarity Boost" feature uses an exclusive API (`Video.msVideoProcessing`) that's only available on Edge browser for desktop at the moment.
|
||||
~~No. The "Clarity Boost" feature uses an exclusive API (`Video.msVideoProcessing`) that's only available on Edge browser for desktop at the moment.~~
|
||||
Fake news! This feature has been implemented in **Better xCloud** since version 1.12, but the original "Clarity Boost" still perform better.
|
||||
|
||||
6. **Will it be able to request a lower FPS or increase the maximum bitrate (15Mbps) of the stream?**
|
||||
7. **Will it be able to request a lower FPS or increase the maximum bitrate (15Mbps) of the stream?**
|
||||
Sorry, no. The server decides all these settings.
|
||||
|
||||
7. **What's the meaning behind the name "Better xCloud"?**
|
||||
8. **What's the meaning behind the name "Better xCloud"?**
|
||||
It's a reference to an Userscript called "better360" that I created many years ago. I regret not choosing the name "xCloud Enhancement Suite", or XES for short.
|
||||
|
||||
## User-Agent
|
||||
Moved to [wiki](https://github.com/redphx/better-xcloud/wiki/User‐Agent).
|
||||
## Translators
|
||||
- **Chinese (Simplified)**: [@nyavana](https://github.com/nyavana)
|
||||
- **French**: rodolphe.chouteau, Stay34yth
|
||||
- **German**: [@KingNothing81](https://github.com/KingNothing81), mynameismanu
|
||||
- **Korean**: [@rightones](https://github.com/rightones)
|
||||
- **Italian**: Greenylie, Rakan129, Carza-104, graziequalcuno, DioCannabinoide
|
||||
- **Japanese**: Tak_attack, udonshi
|
||||
- **Portuguese (Brazilian)**: [@ricardo404](https://github.com/ricardo404), [@Haisom](https://github.com/Haisom), italorafael22062009, PotatoPTT, guilhermecursi, renatomaster01
|
||||
- **Polish**: [@aleksishere](https://github.com/aleksishere)
|
||||
- **Russian**: anpom6, soophik
|
||||
- **Spanish**: [@PabloSebas](https://github.com/PabloSebas), csvnchzn
|
||||
- **Turkish**: [@transbebek](https://github.com/transbebek)
|
||||
- **Ukrainian**: glebanych
|
||||
- **Vietnamese**: [@redphx](https://github.com/redphx)
|
||||
|
||||
Visit [here](https://crowdin.com/project/better-xcloud) if you want to translate **Better xCloud** to more languages.
|
||||
Use [this post](https://github.com/redphx/better-xcloud/discussions/131) for discussion.
|
||||
|
||||
## Donation
|
||||
I'm doing this for fun, so you don't have to donate anything. You're already supporting me by using this script. Save that money toward your Xbox Game Pass Ultimate subscription 😄.
|
||||
But if you still really want to donate, I have a [Ko-fi page](https://ko-fi.com/redphx). Thank you.
|
||||
|
||||
## Acknowledgements
|
||||
- [n-thumann/xbox-cloud-server-selector](https://github.com/n-thumann/xbox-cloud-server-selector) for the idea of IPv6 feature
|
||||
- Icons by [Phosphor Icons](https://phosphoricons.com)
|
||||
|
||||
## Disclaimers
|
||||
- Use as it your own risk.
|
||||
- Use it at your own risk.
|
||||
- This project is not affiliated with Xbox in any way. All Xbox logos/icons/trademarks are copyright of their respective owners.
|
||||
|
@ -1,5 +1,5 @@
|
||||
// ==UserScript==
|
||||
// @name Better xCloud
|
||||
// @namespace https://github.com/redphx
|
||||
// @version 1.10.2
|
||||
// @version 2.1.2
|
||||
// ==/UserScript==
|
||||
|
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user