Repository navigation
LunaNX v1.1
LunaNX v1.1 — 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 v1.1
New features
- 8 interface languages: Deutsch, English, Español, Français, Italiano, Português, Русский
and 简体中文. English by default, changeable at any time in Settings → Language. The Luna
catalog and game texts follow the chosen language when your store offers it. - Store choice at first launch: pick your Amazon store (France, Germany, United Kingdom,
Spain, Italy, United States or Canada) before signing in. LunaNX then connects to the right
Luna service and switches to the store's language. - Complete Luna catalog: LunaNX now browses the Luna catalog live in the background ("All
games", genres, collections), so games that are not on the home page (for example Sonic Mania)
appear too, instead of only the games of the home rows. - Paged "All games" grid: 10 covers per page, with Previous page / Next page buttons or
the L / R buttons. - Automatic return to the library when a game session ends.
- Loading animation (three purple dots) until the game picture appears.
Fixes and optimizations
- Fixed a crash when browsing to the last games of the library: only the covers of the current
page are kept in memory, and oversized artwork is downscaled before display. - Fixed games shown two or three times in the library: duplicates are now detected by Amazon
ID or by title. - Fixed a crash when changing the language in Settings.
What's next: v1.2
A v1.2 is already in preparation. It will take community feedback into account and add
support for more features (details to come). Suggestions and bug reports are welcome in the
Issues page.
Features
- Amazon sign-in on the console: the official Amazon sign-in page opens in the Switch
browser; 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 and complete the sign-in in the Switch
browser.
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). - 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 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."




