Files
DroidDeck/tools/xcloud-player/NOTICE.md
The412Banner c5d7cdc058 Xbox Cloud Gaming: stream from the store and Games tab, native player with DroidDeck frame generation (#1531)
Xbox Cloud Gaming: stream from the store and Games tab, native player with DroidDeck frame generation

Stream Xbox games with Xbox Cloud Gaming (Game Pass) from DroidDeck, outside
the Linux session.

- Backend: `xodus-cli cloud-token` (tools/xbox/droiddeck-cloud-token.patch)
  gets the streaming tokens; they stay in memory.
- Web player (default): the Greenlight player page (tools/xcloud-player, MIT)
  in a WebView, plus Microsoft's own xbox.com/play player. In-stream menu with
  screen effects (sharpen, colour, deband, FXAA, CRT, NTSC, Toon, fps cap),
  stream quality, performance overlay (level, layout, top right / top left)
  and rumble.
- Native player (opt-in, Android 10+, Player engine: Native): Google's WebRTC
  (io.github.webrtc-sdk 125.6422.07, BSD) with the Greenlight protocol ported
  to Kotlin, in its own process (:xcloudnative) with its own instance of
  DroidDeck's compositor. Decoded frames reach the compositor as
  AHardwareBuffers (new stream mode, VK_ANDROID_external_memory_android_
  hardware_buffer import), so DDFG 2x and LSFG 2x/3x/4x run on them. Live
  frame generation, frame-rate target (presets and a 10-165 fps slider, even
  pacing), zero-copy picture, small network buffer, fast decoder, instant
  controller input, overlay with engine and on-screen fps, background end,
  restart and web fallback. It takes the main process's tokens through
  XboxCloudTokenService; they are fetched ahead while a cloud game is shown.
- The compositor requests the dma-buf import extensions only where the driver
  has them (the system driver has none).
- Catalog: cloud availability, Game Pass plan CFQ7TTC0K6L8 counted, library
  filter All / Owned / Game Pass / Cloud, Stream and Add to Games on the store
  page, stream-only Games-tab entries (Stream + Download / Play + Stream).
- Xbox games get VC++ 2015-2022 and the ARM64 runtime registry entries
  (vcredist2022_arm64, built in until the catalog has it) before each launch.
- Controller focus reaches pickers opened from a game page (install location,
  uninstall); Add / Remove from Games keep the focus.

Credits: Greenlight by UnknownSKL (Jim Kroon), MIT, player and protocol;
Better xCloud for the resolution / OS mapping; MGamer404's Bannerlator #627
for the ARM64 runtime approach. Ported from the412banner's Bannerlator.
2026-10-24 23:17:57 -04:00

1.4 KiB

Xbox Cloud Gaming player

greenlight/lib is the WebRTC client of Greenlight by UnknownSKL (Jim Kroon) (https://github.com/unknownskl/greenlight, packages/player/src/client/lib, commit ef852c3, MIT — see greenlight/LICENSE). DroidDeck changes: player.ts renders video with the <video> component instead of WebGPU, render/video.ts sets a transparent poster, and input/gamepad.ts treats missing buttons/axes as unpressed (Android reports no guide button); uuid is replaced by uuid.ts (crypto.randomUUID).

sdp-tweaks.ts (H.264 profile preference, bitrate cap), the CAS / unsharp-mask sharpening in renderer.ts and the "stop quality drops" metadata change follow Better xCloud by redphx (https://github.com/redphx/better-xcloud, MIT). The colour, deband, FXAA, Toon, CRT and NTSC shaders are ported from Bannerlator's screen effects (The412Banner). streamstats.ts is DroidDeck's.

entry.ts is DroidDeck's: it drives a cloud session through the app (DDCloud bridge; the streaming and Microsoft account tokens never reach the page) and attaches the first controller.

Build: bash tools/xcloud-player/build.sh (esbuild) writes app/src/main/assets/xcloud/player.js; the built file is committed.

The page, its sources and the Android side (stores/xbox/XboxCloud*.kt) are ported from Bannerlator's Xbox Cloud Gaming player (https://github.com/The412Banner/Bannerlator).