Repository navigation
LunaNX v2.0
LunaNX v2.0 — Amazon Luna on Nintendo Switch
LunaNX is a homebrew application (.nro) that lets you play Amazon Luna cloud games on a
Nintendo Switch running custom firmware. It signs in to your Amazon account, shows your Luna
library, and streams the game to the console with your controller as the input device.
Important
LunaNX is an unofficial community project. It is not affiliated with, endorsed by or
sponsored by Amazon or Nintendo. Amazon Luna and Nintendo Switch are trademarks of their
respective owners. You need your own Amazon account with access to Luna; the games available
depend on your subscription and your country.
What's new in v2.0
Sign in with your phone. On some consoles the Switch browser does not open the Amazon
sign-in page and shows "This feature is not available". LunaNX v2.0 adds a second way to
sign in that does not use the Switch browser at all:
- On the sign-in screen, choose Sign in with my phone.
- Scan the QR code shown on the Switch with your phone or tablet (on the same Wi-Fi network).
- Sign in on the official Amazon page in your phone's browser.
- Copy the address of the last page Amazon shows, paste it into the LunaNX page and send it to
the Switch. Your Luna library appears.
Your password is typed only on Amazon's site: LunaNX never sees it. No PC, no browser extension
and no cookies.txt file are needed.
If the Switch browser works on your console, Sign in with Amazon still lets you sign in
directly on the Switch, without a phone.
LunaNX works with the Amazon stores of the countries where Luna is available: France, Germany,
United Kingdom, Spain, Italy, United States and Canada (with the North American Luna server fix
of v1.2).
I hope you'll enjoy this update and that it finally lets you make the most of Luna on your
Switch! — KazaR-RooT
Earlier versions: see CHANGELOG.md.
What's next
Mouse and keyboard support is planned for a next version. Until then, feel free to share
your feedback, remarks and bug reports in the Issues page: they will shape the
next versions.
Features
- Amazon sign-in, two ways: in the Switch browser, or with your phone (QR code) when the
Switch browser is not available. Both use the official Amazon sign-in page; the session then
renews automatically. Your password is never seen or stored by LunaNX. - Amazon stores: France, Germany, United Kingdom, Spain, Italy, United States and Canada,
chosen at first launch. - Interface in 8 languages: Deutsch, English, Español, Français, Italiano, Português,
Русский, 简体中文. - Luna library, loaded automatically:
- Featured banner,
- Continue playing (your last 10 games launched from LunaNX),
- Top 10 (current Luna ranking, when Luna provides it for your account),
- All games: the complete catalog, explored live, shown as pages of 10 covers,
- optional simple list view.
- Game streaming: 720p at 60 fps, H.264 video, stereo audio, with bitrate adapted to your
network. - Automatic server selection based on measured latency (a server region can also be chosen
manually). - Controllers: Joy-Con, Pro Controller and handheld mode, with rumble. Switch button
labels by default (Xbox layout available); the D-pad can also drive the left stick. - Settings: language, Amazon store, sign out, library view, server region, button layout,
sound, volume, audio buffer, optional in-game technical overlay.
Screenshots
| Luna library | In game |
|---|---|
![]() |
![]() |
| Launching a game | Settings |
![]() |
![]() |
Requirements
- A Nintendo Switch able to run homebrew (custom firmware such as Atmosphère, with the
Homebrew Menu). - An internet connection (5 GHz Wi-Fi close to the router recommended).
- An Amazon account with access to Amazon Luna in your country.
Installation
See INSTALLATION.md for step-by-step instructions. In short:
- Copy
LunaNX.nrotosdmc:/switch/LunaNX/on your SD card. - Start LunaNX from the Homebrew Menu in application mode (hold R while launching a game).
- Choose your Amazon store, then Sign in with Amazon (Switch browser) or Sign in with my
phone (QR code), and complete the sign-in on the official Amazon page.
Usage
- Your Luna library appears after sign-in.
- Move with the D-pad or the left stick, then press A on a cover to start the game.
- To leave a game, press ZL + ZR + − at the same time.
| Action | Button |
|---|---|
| Launch a game | A on a cover |
| Settings | Settings button (top right) or X |
| Refresh the library | Refresh button or Y |
| Previous / next page of "All games" | L / R |
| Quit LunaNX (library) | + |
| Start / Xbox button (in game) | + short press / long press |
| Left stick (in game) | left stick or D-pad |
| Technical overlay (in game, if enabled in Settings) | L3 + R3 |
| Quit a game | ZL + ZR + − |
Known limitations
- Streaming quality is fixed at 720p 60 fps with software decoding.
- Application mode is required: the Switch browser used for sign-in and the memory needed
for streaming are not available from the Album (applet mode). - Phone sign-in: the phone or tablet must be on the same Wi-Fi network as the Switch; guest
networks that isolate devices from each other block it. Paste the address soon after signing
in: Amazon's sign-in code is only valid for a short time. - No keyboard or mouse support: games that require them cannot be controlled.
- Parental control PIN prompts from Luna are not supported.
- Game availability depends on your Luna subscription and your country. Luna does not say in
its catalog which subscription includes each game: a game outside your subscription shows the
message "This game cannot be launched with this account". - Arabic and Hebrew interfaces are not available (no right-to-left text support).
Compatibility
- Tested on a Nintendo Switch running custom firmware, launched from the Homebrew Menu in
application mode. - Not tested on every console model or firmware version: please report problems in the
Issues page.
Security and privacy
- Your Amazon session is stored on your SD card in
sdmc:/switch/LunaNX/amazon_device.json.
Never share this file. Use Settings → Sign out of Amazon before lending or selling your
console; you can also remove "LunaNX" from your Amazon account → Manage your devices. - Log files in
sdmc:/switch/LunaNX/can contain your IP address: remove it before sharing a
log in an issue.
Download and integrity check
Download LunaNX.nro from the Releases page. Its SHA-256 checksum is
given in the release notes; to check it on macOS or Linux:
shasum -a 256 LunaNX.nroLicense and source code
LunaNX is distributed under the GNU General Public License v3.0 (see LICENSE).
This repository contains the complete source code of LunaNX:
github.com/kazar-root/LunaNX.
Third-party components and their licenses are listed in
THIRD_PARTY_NOTICES.md, with the full license texts in
licenses/.
Building from source
Requirements: devkitPro with the following
packages, plus CMake and Ninja.
sudo dkp-pacman -S --needed devkitA64 switch-dev switch-curl switch-jansson switch-mbedtls \
switch-ffmpeg switch-dav1d switch-libopus switch-glfw switch-libdrm_nouveau switch-zlib \
switch-freetype switch-libpng switch-libwebp switch-sdl2 ninja
python3 -m pip install --user cmake
./build.shThe output file is build/LunaNX.nro.
Acknowledgments
Thanks to the developers of the open-source projects LunaNX is built on:
devkitPro, libnx and deko3d,
Borealis,
libpeer,
Mbed TLS,
libsrtp,
usrsctp,
FFmpeg and averne's
NVTEGRA branch,
Moonlight-Switch,
OpenNOW-Switch,
curl, Jansson,
cJSON, Yoga,
NanoVG, fmt,
zlib, bzip2, Project Nayuki's QR Code generator
and Google's Material Icons.
Created by KazaR-RooT
Developed with the assistance of Claude Code (Anthropic).
"The only limit is your imagination. AI makes it possible."




