mirror of
https://github.com/redphx/better-xcloud.git
synced 2025-06-29 02:41:44 +02:00
Compare commits
11 Commits
Author | SHA1 | Date | |
---|---|---|---|
c47caea65e | |||
6f540cca7a | |||
7a202ba8a7 | |||
1f787b7888 | |||
0cc96135c9 | |||
ed2fb13e17 | |||
b91474c20b | |||
18eec8b8da | |||
949a180047 | |||
c9a67cf6b7 | |||
b469ba4867 |
1
.github/FUNDING.yml
vendored
Normal file
1
.github/FUNDING.yml
vendored
Normal file
@ -0,0 +1 @@
|
|||||||
|
ko_fi: redphx
|
106
README.md
106
README.md
@ -11,20 +11,57 @@ If you like this project please give it a 🌟. Thank you 🙏.
|
|||||||
|
|
||||||
|
|
||||||
## Table of Contents
|
## Table of Contents
|
||||||
- [**Features**](#features)
|
|
||||||
- [**How to install**](#how-to-install)
|
- [**How to install**](#how-to-install)
|
||||||
- [**Compatibility**](#compatibility)
|
- [**Compatibility**](#compatibility)
|
||||||
|
- [**Features**](#features)
|
||||||
- [**Stream stats**](#stream-stats)
|
- [**Stream stats**](#stream-stats)
|
||||||
- [**Capture screenshot**](#capture-screenshot)
|
- [**Capture screenshot**](#capture-screenshot)
|
||||||
- [**FAQ**](#faq)
|
- [**FAQ**](#faq)
|
||||||
|
- [**Translators**](#translators)
|
||||||
- [**Donation**](#donation)
|
- [**Donation**](#donation)
|
||||||
- [**Acknowledgements**](#acknowledgements)
|
- [**Acknowledgements**](#acknowledgements)
|
||||||
- [**Disclaimers**](#disclaimers)
|
- [**Disclaimers**](#disclaimers)
|
||||||
|
|
||||||
|
## How to install
|
||||||
|
1. Install [Tampermonkey extension](https://www.tampermonkey.net/) on suppported browsers.
|
||||||
|
For Safari, use the [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).
|
||||||
|
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.
|
||||||
|
|
||||||
|
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 | macOS | Android/Android TV | iOS |
|
||||||
|
|-----------------------------------------|:-----------------|:-----------------|:-------------------|:-----------------|
|
||||||
|
| Chrome/Edge/Chromium variants | 👍 | 👍 | ❌ | ❌ |
|
||||||
|
| 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
|
## Features
|
||||||
|
|
||||||
<img width="400" alt="Settings UI" src="https://github.com/redphx/better-xcloud/assets/96280/0eedde97-74c7-44df-bc89-2ebf8edb6e2c">
|
<img width="400" alt="Settings UI" src="https://github.com/redphx/better-xcloud/assets/96280/f759db0b-dcb6-46d9-99a0-044d2d431ee5">
|
||||||
<br>
|
<br>
|
||||||
<img width="600" alt="Stream HUD" src="https://github.com/redphx/better-xcloud/assets/96280/51bdb96c-79ab-402f-902a-a9e6229973b2">
|
<img width="600" alt="Stream HUD" src="https://github.com/redphx/better-xcloud/assets/96280/51bdb96c-79ab-402f-902a-a9e6229973b2">
|
||||||
<br>
|
<br>
|
||||||
@ -60,11 +97,8 @@ If you like this project please give it a 🌟. Thank you 🙏.
|
|||||||
- **Set target resolution**
|
- **Set target resolution**
|
||||||
> By default you only get 1080p stream when playing on desktop.
|
> 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.
|
> This feature can give you 1080p stream even on mobile, without having to change User-Agent.
|
||||||
- **Force high-quality codec (if supported)<sup>(\*)</sup>**
|
- **Change visual quality**
|
||||||
> Force xCloud to use the best streaming codec profile (same as desktop & TV) if possible. You don't have to change User-Agent anymore.
|
> Increase/decrease the quality of the stream to your liking. Only works in Chrome/Edge/Kiwi...
|
||||||
> You should enable this feature even if you're on desktop.
|
|
||||||
> Not available for some browsers (Firefox, Safari...).
|
|
||||||
> Use more bandwidth & battery.
|
|
||||||
> Comparison video with the setting ON & OFF: https://youtu.be/-9PuBJJSgR4
|
> Comparison video with the setting ON & OFF: https://youtu.be/-9PuBJJSgR4
|
||||||
- **Disable bandwidth checking**
|
- **Disable bandwidth checking**
|
||||||
> xCloud won't warn about slow connection speed.
|
> xCloud won't warn about slow connection speed.
|
||||||
@ -153,51 +187,6 @@ If you like this project please give it a 🌟. 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.
|
<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 install
|
|
||||||
1. Install [Tampermonkey extension](https://www.tampermonkey.net/) on suppported browsers. For Safari, use the [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).
|
|
||||||
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).
|
|
||||||
|
|
||||||
⚠️⚠️⚠️ 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.
|
|
||||||
|
|
||||||
### 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
|
|
||||||
- 👍 = 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 | macOS | Android/Android TV | iOS |
|
|
||||||
|-----------------------------------------|:-----------------|:-----------------|:------------------|:-----------------|
|
|
||||||
| Chrome/Edge/Chromium variants | 👍 | 👍 | ❌ | ❌ |
|
|
||||||
| Firefox | ✅ | ✅ | 🗒️<sup>(1)</sup> | ❌ |
|
|
||||||
| Safari | ➖ | ✅<sup>(2)</sup> | ➖ | ✅<sup>(3)</sup> |
|
|
||||||
| [Kiwi Browser](https://kiwibrowser.com) | ➖ | ➖ | 👍 | ➖ |
|
|
||||||
| [Hermit](https://hermit.chimbori.com) | ➖ | ➖ | 🗒️<sup>(4)</sup> | ➖ |
|
|
||||||
|
|
||||||
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.
|
|
||||||
<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
|
## Stream stats
|
||||||
|
|
||||||

|

|
||||||
@ -277,11 +266,16 @@ Sorry, no. The server decides all these settings.
|
|||||||
8. **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.
|
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.
|
||||||
|
|
||||||
## Donation
|
## Translators
|
||||||
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 😄.
|
- **Portuguese (Brazilian)**: [@ricardo404](https://github.com/ricardo404)
|
||||||
|
- **Vietnamese**: [@redphx](https://github.com/redphx)
|
||||||
|
|
||||||
## User-Agent
|
Visit [here](https://crowdin.com/project/better-xcloud) if you want to translate **Better xCloud** to more languages.
|
||||||
Moved to [wiki](https://github.com/redphx/better-xcloud/wiki/User‐Agent).
|
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
|
## Acknowledgements
|
||||||
- [n-thumann/xbox-cloud-server-selector](https://github.com/n-thumann/xbox-cloud-server-selector) for the idea of IPv6 feature
|
- [n-thumann/xbox-cloud-server-selector](https://github.com/n-thumann/xbox-cloud-server-selector) for the idea of IPv6 feature
|
||||||
|
@ -1,5 +1,5 @@
|
|||||||
// ==UserScript==
|
// ==UserScript==
|
||||||
// @name Better xCloud
|
// @name Better xCloud
|
||||||
// @namespace https://github.com/redphx
|
// @namespace https://github.com/redphx
|
||||||
// @version 1.16
|
// @version 1.17
|
||||||
// ==/UserScript==
|
// ==/UserScript==
|
||||||
|
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user