Bump version to 1.18.1

Update README.md
2025-06-28 18:31:44 +02:00 · 2023-10-26 20:06:46 +07:00 · 2023-10-26 20:06:27 +07:00 · 2023-10-26 20:05:57 +07:00 · 2023-10-26 15:43:33 +07:00 · 2023-10-26 15:28:13 +07:00
4 changed files with 2391 additions and 611 deletions
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@ -0,0 +1 @@
+ko_fi: redphx
--- a/README.md
+++ b/README.md
@ -2,35 +2,76 @@
 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 🙏.

 [![Latest version](https://img.shields.io/github/v/release/redphx/better-xcloud?label=latest)](https://github.com/redphx/better-xcloud/releases) 
-[![Total stars](https://img.shields.io/github/stars/redphx/better-xcloud?color=%23cca400)](https://github.com/redphx/better-xcloud/stargazers)  
-<!--
 [![Total downloads](https://img.shields.io/github/downloads/redphx/better-xcloud/total?color=%23e15f2c)](https://github.com/redphx/better-xcloud/releases) 
-->
+[![Total stars](https://img.shields.io/github/stars/redphx/better-xcloud?color=%23cca400)](https://github.com/redphx/better-xcloud/stargazers)  
+

 ## 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/8baddcfa-b528-4ba7-9392-7b5fe60cea11">
 <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/a8614693-7f56-4a49-82ad-c1fd7e2e00a5">
-
+<img width="600" alt="Stream settings" src="https://github.com/redphx/better-xcloud/assets/96280/18ed4598-4eca-4626-9434-5f74266b00e7">

 &nbsp;  
  
@ -62,14 +103,14 @@ 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**  
@ -93,14 +134,13 @@ If you like this project please give it a 🌟. Thank you 🙏.
  > <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
+- **Show game art**
  > Replace the black background with game art if it's available.  
- Show the estimated wait time
+- **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.
-  > Don't be mad when the estimated time is inaccurate.  
+  > 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
+- **Show/hide the rocket animation**
  > Always show/Hide when queuing/Always hide.  
  > Hide this animation might save some battery life while queuing.  
  
@ -123,8 +163,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".  
@ -135,7 +177,7 @@ If you like this project please give it a 🌟. Thank you 🙏.
  > ![clarity](https://github.com/redphx/better-xcloud/assets/96280/ed63bbb0-fcbf-43e2-8e51-ac2733e697b8)
  > *(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.  
@ -155,50 +197,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)
@ -215,7 +213,7 @@ Don't see your browser in the table? If it supports Tampermonkey/Userscript then
 |------:|:-------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------|
 | 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 in Kiwi Browser [#26](https://github.com/redphx/better-xcloud/issues/26)) |
+| 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                                       |
@ -278,11 +276,25 @@ 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
--- 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.14.1
+// @version      1.18.1
 // ==/UserScript==
--- a/better-xcloud.user.js
+++ b/better-xcloud.user.js
Author	SHA1	Message	Date
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
redphx	6cd2648325	Update README.md	2023-09-04 10:40:14 +07:00
redphx	fa0d761d24	Bump version to 1.15	2023-09-04 10:37:31 +07:00
redphx	f01d7a3b0b	Bump version to 1.15	2023-09-04 10:37:12 +07:00
redphx	b520e8173e	Update README.md	2023-09-04 10:36:43 +07:00
redphx	f15f43faf7	Remove "Bitrate" & "Decode Time" stats from default items	2023-09-04 10:31:52 +07:00
redphx	e470cb20a3	Replace "Stretch Video" setting with "Video Ratio" (#121 ) * Make Game Pass' app version easier to read * Replace numberPicker with NumberStepper * Replace "Stretch Video" setting with "Video Ratio" * Make number stepper's buttons a little bit bigger	2023-09-04 09:11:08 +07:00
redphx	d1882046e2	Update README.md	2023-08-29 08:42:04 +07:00
redphx	fb7bd2da0d	Update README.md	2023-08-28 14:31:13 +07:00