gitwtfhub

wtf is green-nx?

rmrf404/green-nx — explained in plain English

Analysis updated 2026-05-18

28C++Audience · developerComplexity · 4/5LicenseSetup · hard

TL;DR

A homebrew app that lets you play Xbox Cloud Gaming titles on a modified Nintendo Switch by streaming directly from the console, with no companion device needed.

Mindmap

mindmap
  root((repo))
    What it does
      Streams Xbox games
      Plays on Switch
      No companion device
    Tech stack
      C++ homebrew
      WebRTC streaming
      H264 hardware decode
    Requirements
      Modified Switch
      Game Pass Ultimate
      5GHz Wi-Fi
    Use cases
      Play Xbox on Switch
      Browse game library
      Stream at 1080p
    Audience
      Homebrew enthusiasts
      Xbox Game Pass users
      Switch modders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Play Xbox Game Pass titles on a modified Nintendo Switch over Wi-Fi.

REASON 2

Browse and search your Xbox game library with cover art on the Switch.

REASON 3

Stream Xbox Cloud Gaming at up to 1080p with full controller support.

REASON 4

Adjust stream quality and controller mappings from an in-app settings menu.

What's in the stack?

C++WebRTCH.264OpusAtmosphere CFW

How it stacks up

rmrf404/green-nxfrankkk96/flashqwenlostamongrectify/seed-phrase-generator
Stars282828
LanguageC++C++C++
Setup difficultyhardhard
Complexity4/55/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 30min

Requires a Switch running Atmosphere custom firmware, an active Xbox Game Pass Ultimate subscription, 5 GHz Wi-Fi, and launching in title mode with R held due to memory limits.

You may use, modify, and distribute this code freely, but any derivative works must also be licensed under GPL-3.0 and remain open source.

Wtf does this do

green-nx is a homebrew application that lets you play Xbox Cloud Gaming titles on a modified Nintendo Switch. After signing in with your Microsoft account, you can stream your Xbox Game Pass Ultimate library directly on the console. All the streaming work happens on the Switch itself, with no companion phone or PC required. The app is fully working. You can sign in, browse your game library with cover art, search for titles, and stream gameplay at 720p, 1080p, or 1080p HQ with audio and full controller input. Sign-in uses a device code method, so you never type a password on the console. Your login tokens and cached game list are stored on the SD card. Under the hood, the app handles the WebRTC streaming protocol entirely on the Switch. This includes the connection setup, encrypted media transport, and data channels for controller input. Video arrives as an H.264 stream that is decoded by the Switch's dedicated hardware decoder, then passed straight to the screen through the GPU with no intermediate memory copying. Audio uses the Opus format, and video targets 60 frames per second. To run it, you need a Switch running the Atmosphere custom firmware, an active Xbox Game Pass Ultimate subscription, and a 5 GHz Wi-Fi connection. You copy the app file to your SD card and launch it in title mode by holding R while starting an installed game, because the smaller applet mode does not have enough memory for video decoding. The app includes a settings menu for stream quality and button layout, and in-stream controls are mapped from the Switch gamepad to Xbox equivalents. The project is open source under GPL-3.0 and builds on several existing libraries for WebRTC, encryption, audio decoding, and user interface rendering. The author notes that it is an experimental, non-commercial hobby project with no affiliation to Microsoft or Nintendo, and requires your own valid Game Pass subscription.

Yoink these prompts

Prompt 1
I want to build a homebrew Switch app that streams WebRTC video. Based on green-nx, how would I handle hardware H.264 decoding and pass frames to the GPU without intermediate memory copies?
Prompt 2
Help me implement a device code sign-in flow for a custom Switch app so users can authenticate with a Microsoft account without typing a password on the console.
Prompt 3
I am building a WebRTC client on an embedded device. How should I structure the connection setup, encrypted media transport, and data channels for controller input, similar to how green-nx handles it?
Prompt 4
What are the key considerations for decoding Opus audio and H.264 video on the Switch hardware while targeting 60 frames per second, based on the approach used in green-nx?

Frequently asked questions

wtf is green-nx?

A homebrew app that lets you play Xbox Cloud Gaming titles on a modified Nintendo Switch by streaming directly from the console, with no companion device needed.

What language is green-nx written in?

Mainly C++. The stack also includes C++, WebRTC, H.264.

What license does green-nx use?

You may use, modify, and distribute this code freely, but any derivative works must also be licensed under GPL-3.0 and remain open source.

How hard is green-nx to set up?

Setup difficulty is rated hard, with roughly 30min to a first successful run.

Who is green-nx for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.