- Top Pick: Xbox Wireless Controller — Carbon Black
- Runner-up: Valve Steam Deck OLED 512GB
- Also consider: TP-Link Archer AXE75 AXE5400 Tri-Band Wi-Fi 6E Router
Microsoft publishes no Xbox app for Linux, which leaves two obvious holes: the Xbox Cloud Gaming library has no dedicated client, and streaming games from your own Xbox console has no documented Linux route at all. Greenlight is the community-built answer to both. It is a free, open-source application that signs in to your Microsoft account and turns a Linux desktop or a Steam Deck into an Xbox streaming screen.
It is also unofficial, and this guide treats it that way. Below is what Greenlight does according to its own project documentation, how it differs from the browser cloud player, what Microsoft requires on the account and network side, how setup goes on a desktop and on the Deck, and where the honest limits sit.
As an Amazon Associate, we earn from qualifying purchases.
Quick answer
Greenlight is a free, open-source, unofficial client that brings both halves of Xbox streaming to Linux: it streams the Xbox Cloud Gaming library and it streams games from your own Xbox console at home. Install it from Flathub, sign in with your Microsoft account, and it behaves like the Xbox app Linux never got, Steam Deck included.
What Greenlight is
Greenlight is an open-source client for Xbox Cloud Gaming and Xbox home streaming, written in TypeScript and built as an application wrapper around the project’s own xcloud player library. It runs on Linux, macOS, Windows and Steam Deck, and its documentation carries an explicit disclaimer that it is not affiliated with Microsoft or Xbox.
One sign-in unlocks both jobs. The cloud side lists the streaming library attached to your account, ready to launch without any console in the house. The console side lists your own Xbox machines and streams the games installed on them, which is the half of Xbox streaming that Linux otherwise has no route to. Around those two jobs the project adds the furniture of a real client rather than a web page: gamepad control throughout the interface, a built-in online friends list, keyboard controls for pad-free machines, rumble support on cloud streams, and a streaming statistics overlay, called up with the tilde key, that shows decoder frame rates, latency and buffer behaviour while you play.
How it differs from playing in a browser
The browser is Microsoft’s documented cloud route on Linux, and it works, but it behaves like what it is: a web page. Greenlight’s differences are the ones a dedicated client can offer.
It runs as its own application, so it can start fullscreen and can even auto-connect: its documented launch arguments include a fullscreen flag and a connect argument that starts streaming to a named console or cloud title as soon as you are authenticated. On a Steam Deck that matters, because Greenlight installs in desktop mode and can then be added as a non-Steam game, putting Xbox streaming inside Game Mode next to your Steam library instead of in a browser tab. The project’s own Deck notes recommend mapping a back button to the N key, which is Greenlight’s keyboard shortcut for the Xbox button, so the guide and overlays stay reachable.
The second difference is scope. The browser route covers cloud gaming. Greenlight’s console tab is the part the documented browser route does not give Linux users: a client built for streaming the Xbox under your TV, with your own installed games, your saves and your disc-based library, over your home network or away from it.
What you need before you start
On the account side, the two halves ask for different things. Cloud gaming is part of Game Pass Ultimate, as Microsoft publishes it, so the cloud library only opens for Ultimate members. Streaming your own console is separate: it plays the games installed on that console under your account and does not need the cloud tier.
On the console side, Microsoft’s remote play setup asks you to enable remote features in the console’s settings, under Devices and connections, and to leave the console in the Sleep power option so it can wake when a connection arrives. Sign in to Greenlight with the same Microsoft account the console uses, or it will not appear in your console list.
On the network side, Microsoft lists a minimum download speed of 10 Mbps for cloud gaming and recommends around 20 Mbps for the best experience on PCs and tablets, with a wired connection or a 5 GHz Wi-Fi network preferred over 2.4 GHz. The project lists its own modest baseline for the client machine: a modern Linux distribution, 4 GB of memory and a graphics card with hardware video decoding, because your machine only has to decode video, not render the game.
Setting Greenlight up on Linux
The project’s recommended Linux route is Flathub: install the Flatpak once and updates arrive with the rest of your system. Pre-compiled binaries from the project’s releases page are the alternative for machines without Flatpak, and the source is there if you want to build it yourself.
First launch is a Microsoft sign-in, two-factor prompt included, after which your consoles and the cloud library populate on their own. Pick a console to stream from it, or pick a cloud title to stream from Microsoft’s servers. On the Steam Deck, do the install in desktop mode, then add Greenlight to Steam as a non-Steam game and map that back button to N before you return to Game Mode. If a stream misbehaves, the statistics overlay is the project’s own first debugging stop, and its figures are what the maintainers ask for in bug reports.
The honest limits
Greenlight is an unofficial client talking to Microsoft’s services, so it can break when Microsoft changes its sign-in flow or streaming APIs, and it has before. The fix always has to come from the project, on the project’s schedule. Keep the Flatpak updated and expect the occasional gap.
Quality ceilings are Microsoft’s, not the client’s. Microsoft documents Remote Play at up to 1080p and 60 frames per second, and its cloud material centres on 1080p play at 60 frames per second for most devices, with quality adapting to your connection. No client on Linux can stream past what the services send. Latency is likewise inherent to streaming: fine for most single-player games, a real handicap in competitive shooters. The project itself describes Steam Deck support as working with some small bugs and side effects. And none of this touches PC Game Pass downloads, which remain Windows-only for store reasons that have nothing to do with streaming.
The gear that makes it work
Xbox Wireless Controller — Carbon Black
The reference pad for everything Xbox. Its button prompts are the ones games assume, it pairs with a Linux machine over Bluetooth or runs wired over USB-C, and it is the controller Greenlight’s layout is built around.
Specs:
- Model QAT-00001
- Bluetooth and USB-C connectivity
- Hybrid D-pad and dedicated Share button
- Two AA batteries, with maker-rated battery use up to 40 hours
- 3.5 mm headset jack
Valve Steam Deck OLED 512GB
The natural Greenlight machine. SteamOS gives you a desktop mode for the one-time install and a Game Mode to launch it from afterwards, and Wi-Fi 6E keeps the stream on the cleanest band your router offers.
Specs:
- 512GB NVMe storage
- 7.4-inch HDR OLED display, 1280 x 800, up to 90Hz
- Model 814585022254
- Wi-Fi 6E and Bluetooth
- SteamOS 3 with a full KDE desktop mode
TP-Link Archer AXE75 Wi-Fi 6E Router
Streaming is a network workload before it is a gaming one. A tri-band Wi-Fi 6E router gives the Deck or laptop a dedicated 6 GHz lane, while the console stays wired to the router where it belongs.
Specs:
- Wi-Fi 6E tri-band, AXE5400 combined maker-rated speeds
- Dedicated 6 GHz band for Wi-Fi 6E clients
- 160 MHz channels on the wide bands
- OneMesh support for whole-home expansion
- WPA3 security
JSAUX Docking Station for Steam Deck — HB0603
Docking the Deck buys the two things streams love most: a television and a wired Ethernet port. This six-in-one dock adds both, plus USB ports for a wired controller, while the Deck charges.
Specs:
- Model HB0603, six-in-one hub and stand
- HDMI output rated for 4K at 60Hz
- Gigabit Ethernet port
- Three USB-A 3.0 ports
- USB-C power delivery input up to 100W
8BitDo Ultimate 2C Wireless Controller — Transparent Black
A second pad for the desk or the travel bag. It presents itself to the PC as a standard gamepad, which is all Greenlight reads, and its Hall effect sticks and triggers sidestep the drift that ends cheaper pads.
Specs:
- For Windows PC and Android, works as a standard PC gamepad
- 2.4 GHz wireless and USB-C wired modes
- Maker-stated 1000 Hz polling rate in 2.4 GHz mode
- Hall effect joysticks and triggers
- Remappable L4 and R4 bumpers
How to choose
Start with which half you need. If you own an Xbox console and want its library on your Linux screens, Greenlight is effectively the only client route, and the browser cannot substitute for it. If you only want the cloud catalogue, the browser is Microsoft’s supported path and Greenlight is a comfort upgrade: fullscreen launches, auto-connect arguments, Game Mode on the Deck and the statistics overlay. Then fix the network before the accessories: a wired console and a 5 GHz or 6 GHz client connection improve streams more than any controller does. Buy the pad for the prompts and the dock for the Ethernet port, in that order.
Who should skip this
Skip Greenlight if you want PC Game Pass downloads on Linux; no streaming client changes that, and a dual boot is the honest answer. Skip it if you need an officially supported client that Microsoft answers for, because this is a community project by its own declaration. Skip cloud play entirely if your connection is slow, heavily shared or far from Microsoft’s supported regions, and skip streaming for competitive multiplayer where added latency decides rounds. Finally, skip it if your Xbox library lives on a console you cannot leave in Sleep mode with remote features enabled; console streaming has nothing to connect to without that.
FAQ
Is Greenlight an official Microsoft app?
No. It is an open-source community project, and its own documentation states it is not affiliated with Microsoft or Xbox. You sign in with your normal Microsoft account, and the streams themselves come from Microsoft’s services.
Do I need Game Pass Ultimate to stream my own console?
No. Console streaming plays the games installed on your own Xbox under your account. Game Pass Ultimate is the requirement for the other half, the Xbox Cloud Gaming library.
Greenlight or the browser for cloud gaming?
The browser is Microsoft’s documented route and needs a Chromium-based browser on Linux. Greenlight adds console streaming, fullscreen and auto-connect launch options, a friends list, a statistics overlay and, on Steam Deck, a proper Game Mode presence.
Greenlight stopped working after working fine. What happened?
Most likely Microsoft changed something on the service side. Because the client is unofficial, changes to sign-in or the streaming APIs can break it until the project ships an update, so make sure you are on the latest release before troubleshooting your own setup.
Final verdict
Greenlight is the missing Xbox app for Linux, with an asterisk. For console owners it is the only real route to streaming their own Xbox from a Linux desktop or Steam Deck, and for Ultimate members it wraps the cloud library in a proper client with fullscreen launches, an overlay and Game Mode integration. The asterisk is its unofficial status: it lives at the mercy of Microsoft’s service changes. If you accept that, and your network is up to streaming, it turns a Linux machine into a genuine Xbox screen.











