Skip to content

Repository files navigation

GreenOvercast

screenshot

GreenOvercast is a native Xbox Cloud Gaming client for small ARM64 Linux handhelds. It streams at 720p and uses the H700 video decoder.

Built for the Anbernic RG35XX-H (muOS) and validated on the RG40XX-H (Knulli).

This independent project is not affiliated with or endorsed by Microsoft.

Requires an Xbox Game Pass plan that includes cloud gaming and internet access.

Install

Copy greenovercast.zip to PortMaster's autoinstall folder, then open PortMaster to install it. The folder location for each firmware is listed in the PortMaster FAQ.

When the installation finishes, return to the device frontend and launch GreenOvercast from Ports.

The first launch shows a Microsoft device code. Open microsoft.com/link on another device and enter the code to sign in. Knulli asks you to sign in again after a reboot.

GreenOvercast is experimental and has only been tested on the devices below.

Controls

ButtonAction
D-pad / Left StickNavigate
ASelect
BBack
XOpen search / delete a letter
YChange aspect ratio / clear search
L1 / R1Xbox LB / RB
L2 / R2Xbox LT / RT
StartApply search / Xbox Menu
SelectXbox View
L3 + R3Xbox Guide
Select + StartExit GreenOvercast after holding one second

In-game controls use the standard Xbox controller layout.

The aspect-ratio setting applies to the next game you start. Most games only support 16:9.

Supported devices

DeviceOSStatus
RG35XX-HmuOS 2508.4Tested
RG40XX-HKnulli (Batocera 42)Tested

Hardware decoding currently only works on H700 devices. Other devices fall back to software decoding, which is too slow for normal gameplay.

The release requires glibc 2.38 or newer. ArkOS ships glibc 2.30 and is not supported.

Build

You need a Linux or macOS host with cmake, curl, git, make, patch, perl, and python3.

tools/bootstrap.sh # fetch Zig 0.14.1
tools/zig.sh build smoke # cross-build the aarch64 smoke binary
tools/zig.sh build product-check # compile the Zig product modules
tools/zig.sh build test# host unit tests
tools/zig.sh build fmt-check # format check

Build the release and PortMaster package with:

tools/build-release.sh
PORTMASTER_NEW=/path/to/PortMaster-New tools/package-portmaster.sh

I would recommend using a sparse checkout of PortMaster-New because she's a big one. Here is a great guide made by JeodC to help you with that.

package-portmaster.sh runs the current PortMaster-New checks and archive builder. To queue the finished archive for PortMaster's supported autoinstall flow:

tools/deploy.sh <ssh-host> zig-out/greenovercast.zip

Launch PortMaster from the device frontend to install it. Then launch GreenOvercast from Ports so the frontend owns the display handoff.

License

MPL-2.0. See LICENSE. The Cedar H.264 decoder is LGPLv2.1 and dynamically linked. Third-party licenses are listed in THIRDPARTY.md.

About

Xbox Cloud Streaming app for Linux ARM - H700 devices

Topics

Resources

Contributing

Security policy

Stars

9 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages