Bump version to 1.19

Update README.md
2025-06-28 18:31:44 +02:00 · 2023-11-19 16:22:27 +07:00 · 2023-11-19 16:22:03 +07:00 · 2023-11-19 16:21:31 +07:00 · 2023-11-19 16:09:41 +07:00 · 2023-10-27 17:44:29 +07:00
4 changed files with 2582 additions and 537 deletions
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@ -0,0 +1 @@
+ko_fi: redphx
--- a/README.md
+++ b/README.md
@ -2,6 +2,11 @@
 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.  

+Supported platforms:  
+- Windows, macOS, Linux
+- Android, Android TV
+- iOS, iPadOS
+
 This script makes me spend more time with xCloud, and I hope the same thing happens to you.  
 If you like this project please give it a 🌟. Thank you 🙏.

@ -11,24 +16,62 @@ If you like this project please give it a 🌟. Thank you 🙏.


 ## Table of Contents
- [**Features**](#features)
 - [**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 [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    | 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

-<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/6f1e67b3-65a4-406e-91e0-19be58fc0ff6">
 <br>
-<img width="600" alt="Stream HUD" src="https://github.com/redphx/better-xcloud/assets/96280/e30f6514-13ca-41c6-bff2-979573cff956">
+<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="Video settings" src="https://github.com/redphx/better-xcloud/assets/96280/20756157-917b-4a43-9985-df7bfdc24aa3">
+<img width="600" alt="Stream settings" src="https://github.com/redphx/better-xcloud/assets/96280/18ed4598-4eca-4626-9434-5f74266b00e7">

 &nbsp;  
  
@ -60,19 +103,29 @@ If you like this project please give it a 🌟. Thank you 🙏.
 - **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.  
+  > 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**
@ -120,8 +173,10 @@ If you like this project please give it a 🌟. 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
-
+### In-game settings
+- **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".  
@ -152,50 +207,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.

-## 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
-✅ = 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). 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  

 ![stats](https://github.com/redphx/better-xcloud/assets/96280/736548db-316d-4bb3-a0f8-467766ae810b)
@ -275,16 +286,30 @@ Sorry, no. The server decides all these settings.
 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.  

-## 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 😄.
+## Translators
+  - **Chinese (Simplified)**: [@nyavana](https://github.com/nyavana)
+  - **French**: rodolphe.chouteau
+  - **German**: [@KingNothing81](https://github.com/KingNothing81)
+  - **Korean**: [@rightones](https://github.com/rightones)
+  - **Japanese**: Tak_attack, udonshi
+  - **Portuguese (Brazilian)**: [@ricardo404](https://github.com/ricardo404), [@Haisom](https://github.com/Haisom)
+  - **Polish**: [@aleksishere](https://github.com/aleksishere)
+  - **Russian**: anpom6
+  - **Spanish**: [@PabloSebas](https://github.com/PabloSebas)
+  - **Turkish**: [@transbebek](https://github.com/transbebek)
+  - **Vietnamese**: [@redphx](https://github.com/redphx)

-## User-Agent
-Moved to [wiki](https://github.com/redphx/better-xcloud/wiki/User‐Agent).
+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.
--- a/better-xcloud.meta.js
+++ b/better-xcloud.meta.js
@ -1,5 +1,5 @@
 // ==UserScript==
 // @name         Better xCloud
 // @namespace    https://github.com/redphx
-// @version      1.15
+// @version      1.19
 // ==/UserScript==
--- a/better-xcloud.user.js
+++ b/better-xcloud.user.js
Author	SHA1	Message	Date
redphx	f306cb5eee	Bump version to 1.19	2023-11-19 16:22:27 +07:00
redphx	c1acb689fe	Bump version to 1.19	2023-11-19 16:22:03 +07:00
redphx	5837e30afc	Update README.md	2023-11-19 16:21:31 +07:00
redphx	9b955aabb9	Controller shortcuts (#157 ) * Basic code for GamepadHandler * Take screenshot using Home + RB * Enable shortcuts using setting * Only poll gamepad when playing * Toogle stats using Home + Select * Add basic Toast class * Update translations	2023-11-19 16:09:41 +07:00
redphx	d73f91ed5f	Bump version to 1.18.2	2023-10-27 17:44:29 +07:00
redphx	b918fadaab	Bump version to 1.18.2	2023-10-27 17:44:03 +07:00
redphx	b79775839b	Update README.md	2023-10-27 17:37:19 +07:00
redphx	d3e0ba9d9f	Change "Target Resolution > Auto" to "Default"	2023-10-27 17:26:33 +07:00
redphx	e6e8297632	Clear touch controller's style after switching game	2023-10-27 17:20:06 +07:00
redphx	e94fb28266	Fix TitlesInfo	2023-10-27 17:00:25 +07:00
redphx	11e953c382	Bump version to 1.18.1	2023-10-26 20:06:46 +07:00
redphx	4845ea6994	Bump version to 1.18.1	2023-10-26 20:06:27 +07:00
redphx	0f0072bcb0	Update README.md	2023-10-26 20:05:57 +07:00
redphx	85d156f6b2	Clear Application Insights buffers periodically	2023-10-26 15:43:33 +07:00
redphx	8d24494b02	Add French & Japanese translations	2023-10-26 15:28:13 +07:00
redphx	9d1bca99aa	Clear Analytics Insight buffers no page load	2023-10-26 15:14:35 +07:00
redphx	a8cf0896c5	Loading screen: use Image_Tile when Image_Hero is not available	2023-10-26 15:02:32 +07:00
redphx	4767df442e	Update translations	2023-10-15 17:28:11 +07:00
redphx	8314074957	Update README.md	2023-10-15 17:12:57 +07:00
redphx	6ffa75a4ec	Bump version to 1.18	2023-10-15 17:09:47 +07:00
redphx	7813e6f432	Bump version to 1.18	2023-10-15 17:09:32 +07:00
redphx	75d9639c01	Hide the "Play with friends" section when social features are disabled	2023-10-15 16:23:51 +07:00
redphx	fb80c3662a	Add option to disable post-stream feedback dialog	2023-10-15 16:07:59 +07:00
redphx	9e1d8866ce	Fix minor bugs in StreamMenu	2023-10-15 14:23:08 +07:00
redphx	28438c7c9e	Add German translation	2023-10-10 09:40:05 +07:00
redphx	0cb0901ae2	Add Polish and Spanish translations	2023-10-05 09:27:40 +07:00
redphx	9d7c537eaa	Update README.md	2023-10-03 16:53:43 +07:00
redphx	eccd306d03	Bump version to 1.17.2	2023-10-03 16:51:45 +07:00
redphx	e15afd2396	Bump version to 1.17.2	2023-10-03 16:51:25 +07:00
redphx	f0dbc72987	Add Korean translation	2023-10-03 16:03:49 +07:00
redphx	25bf6c209d	Merge branch 'main' of https://github.com/redphx/better-xcloud	2023-10-03 09:55:14 +07:00
redphx	f229dbdbe4	Update README.md	2023-10-02 21:46:35 +07:00
redphx	e845c902b2	Fix Stats settings dialog being too big on small screens	2023-10-02 17:27:37 +07:00
redphx	c424c6f94b	Add Chinese (Simplified) translation	2023-09-29 08:21:29 +07:00
redphx	1619fb2b26	Bump version to 1.17.1	2023-09-25 20:06:44 +07:00
redphx	d72641ba77	Bump version to 1.17.1	2023-09-25 20:06:22 +07:00
redphx	7c3f00f277	Update README.md	2023-09-25 20:05:50 +07:00
redphx	9bd0ee9097	Fix volume booster feature (#141 ) * Trying to fix the audio problem with volume booster * Add an option to disable volume control feature * Update translations	2023-09-25 19:55:36 +07:00
redphx	a9bb977311	Update TR translation	2023-09-21 07:45:44 +07:00
redphx	3e0653fadf	Add RU & TR to language list	2023-09-20 07:09:42 +07:00
redphx	36f6b04ad9	Add TR translation	2023-09-20 07:08:13 +07:00
redphx	60b70e259b	Add RU translation	2023-09-20 07:06:12 +07:00
redphx	c50e0d6aff	Update BR translation	2023-09-20 07:03:40 +07:00
redphx	a3fd3c9ebe	Update README.md	2023-09-18 09:26:06 +07:00
redphx	c47caea65e	Bump version to 1.17	2023-09-18 08:12:57 +07:00
redphx	6f540cca7a	Bump version to 1.17	2023-09-18 08:12:35 +07:00
redphx	7a202ba8a7	Disable "Visual quality" setting on unsupported browsers	2023-09-18 08:10:52 +07:00
redphx	1f787b7888	Update README.md	2023-09-18 07:56:44 +07:00
redphx	0cc96135c9	Support more languages (#134 ) * Define CSS variables * Shorten CSS prefix "better-xcloud-" to "bx-" * Move Safari's workaround code to the end of the script * Add setting to change Better xCloud's language * Support Vietnamese language * Use the same language as browser * Minor fixes * Add Portuguese (Brazilian) * Update BR translation * Adjust CSS of Settings' reload button * Reload the page after changing language * Fix setting locale on first run * Replace "Force high-quality codec" option with "Visual quality" * Add Italian translation * Update texts * Deprecate "Prefer high-quality codec" setting * Show stat's abbr. in slection box * Reduce border size in stats bar from 2px to 1px * Remove unused texts * Remove Italian translation (because it's unfinised) + update Brazillian + Vietnamese translations	2023-09-18 07:43:03 +07:00
redphx	ed2fb13e17	Create MouseHoldEvent	2023-09-13 17:40:54 +07:00
redphx	b91474c20b	Hide Stream Settings dialog when opening Stream Menu	2023-09-13 17:18:50 +07:00
redphx	18eec8b8da	Update CSS selectors for REDUCE_ANIMATIONS	2023-09-13 17:00:00 +07:00
redphx	949a180047	Update README.md	2023-09-13 16:54:29 +07:00
redphx	c9a67cf6b7	Create FUNDING.yml	2023-09-13 16:48:12 +07:00
redphx	b469ba4867	Update README.md	2023-09-11 14:40:49 +07:00
redphx	a0d0d6e1e6	Update README.md	2023-09-10 17:51:42 +07:00
redphx	cc466ff2ac	Bump version to 1.16	2023-09-10 17:16:11 +07:00
redphx	b1bfe96935	Bump version to 1.16	2023-09-10 17:15:47 +07:00
redphx	241be49d09	Update README.md	2023-09-10 17:15:23 +07:00
redphx	7c48b7e6fb	Volume booster (#125 ) * Move Video settings box from bottom to the right side * Rename "Video Settings" to "Stream Settings" * Volume booster * Fix volume booster not working * Typo * Fix not working in Kiwi * Show input range * Update monkey patching method for AudioContext * Refactor Preferences * Add tick markers * Add Audio & Video headers * Reduce stats bar size * Show warning when Clarity Boost mode is ON * Increase max volume to 600 * Try to fix audio problem on iOS/iPadOS * Pause <audio> * Fix crashing when enabling touch controller * Fix touch controller not working * Fix volume booster not working on iOS/iPadOS	2023-09-10 17:04:23 +07:00
redphx	cc9a644a5e	Bump version to 1.15.1	2023-09-08 17:24:05 +07:00
redphx	a77db68afb	Bump version to 1.15.1	2023-09-08 17:23:46 +07:00
redphx	cd7a7c92c7	Validate settings when getting its values	2023-09-08 17:16:38 +07:00
redphx	651402a6b4	Restore stretch to full screen feature	2023-09-08 17:15:45 +07:00