Nintendo 3DS games in VR, running standalone on the Valve Steam Frame. It is my unofficial fork of Azahar, with the VR modes of amwatson's CitraVR.
- Stereoscopic 3D at 90 or 120 Hz, with a touch Secondary Screen
- Switch between VR and Flat mid-game
- Immersive Mode with Natural 3D, matched to your IPD
- A redesigned VR menu with save states and autosave
- In-app cheat, mod and texture pack downloader
- Homebrew and mod pack support, including Angel's Aim for Kid Icarus: Uprising
- Edit the controls of any gamepad or mouse
- VR or Flat, any time: press both bumpers, View and Menu together.
- Immersive Mode: the game draws a wider view, from a big screen fixed in the room to a camera that moves with your head.
- Natural 3D: the game is drawn true to scale, from your IPD as the Steam Frame measures it. At 100% 3D Depth, distant scenery sits at essentially infinity.
- World Scale: how big the game world feels, from 10% to 400%.
- Immersive presets: The Legend of Zelda: Ocarina of Time 3D, Majora's Mask 3D, Super Mario 3D Land and Mario Kart 7 start with settings tuned for the Frame.
Hold Menu for 1 second to open the completely redesigned VR menu. It supports global and per-game settings.
It has an in-app cheat, mod and texture pack downloader:
- Cheats: from the Sharkive 3DS database, and fixes I made in 3ds-game-fixes
- Mods and texture packs: a curated list of creators' own uploads on GameBanana, GitHub, MEGA and Google Drive
Nothing is hosted by this project. The app only fetches files from their original sources, and each entry links to its creator's page.
A Verified chip marks entries known to work in Azahar for Frame. A check-mark badge marks the recommended cheat, mod or texture pack for a game.
- Homebrew (beta): the first entry is Emerald 3DS by ZallaxDev. It downloads from its GitHub and builds from a Pokémon Emerald ROM dumped from your own cartridge.
- CTGP-7: with Mario Kart 7 open, the Mods tab installs CTGP-7 by PabloMK7 and the CTGP-7 team. It downloads only from the official CTGP-7 page. Nothing of CTGP-7 is included or redistributed.
- Angel's Aim (alpha): a Kid Icarus: Uprising mod pack I'm building. Direct Aim lets you point and shoot. All 108 weapons are rebuilt as 3D models in your hand, with their effects, from your own copy of the game. More on its page.
- Accurate Image Copies (Settings > Graphics) fixes the shimmer and glow in the Fire Emblem 3DS games (Echoes, Awakening and Fates) at raised internal resolutions. Its default, Automatic, applies it only where a frame needs it.
- Black Frame Insertion: a clearer picture when you turn your head (in Immersive Mode especially). It may flicker in games with heavier rendering.
- Detach Screens: move the Primary and Secondary Screens apart in 3D space.
- SteamOS Stable or Beta
- A Steam Frame with about 500 MB of free storage
- Your own 3DS games, dumped from your own console
-
Get the repository:
git clone -b steam-frame https://github.com/simplysanatori/AzaharFrame.git cd AzaharFrame -
Download
azaharframe-1.2.1-linux-arm64.tar.gzfrom Releases and install it:steam-frame/install.sh ~/Downloads/azaharframe-1.2.1-linux-arm64.tar.gz -
Launch Azahar for Frame from your Steam library.
Other installers:
- Frametanium: add
simplysanatori/AzaharFrame. - FrameDrop: Install with FrameDrop.
Checksums and building: user guide.
- Double-click the empty game list and select the folder with your games.
- Double-click a game to start it.
Keys and texture packs: user guide.
| Steam Frame | What it does |
|---|---|
| A, B, X, Y | 3DS B, A, Y, X (by position) |
| Hold Menu for 1 second | In-game menu |
| Hold View for 1.5 seconds | Stop the game |
| Hold View, then right or left bumper | Quick Save or Quick Load |
| Hold View, then right trigger | Fast Forward on or off |
| Both bumpers + View + Menu | Switch between VR and Flat |
| Trigger on the Secondary Screen | Touch |
To change them, use Edit Controls on the in-game menu's Controls tab. Full list: docs/CONTROLS.md.
Quit the emulator, then install the new tarball.
steam-frame/install.sh ~/Downloads/azaharframe-<version>-linux-arm64.tar.gzAdd --purge to also delete your settings, saves and keys. Your games are never touched.
steam-frame/uninstall.sh- The installer says Steam was not reachable: start Steam and run
install.shagain. - The SteamVR dock shows a question mark: restart Steam once.
- The screens do not appear: start SteamVR first, then Azahar for Frame.
- An encrypted game does not start: it needs
aes_keys.txtin~/.local/share/AzaharFrame/user/sysdata/. - Azahar Ran Out of Memory: turn off Preload Custom Textures, or use Optimize for Frame on the pack.
More: docs/USER_GUIDE.md.
Use Report a Problem: Settings > General > Help in the in-game menu, or Help in Azahar's window.
See What's Sent shows the whole report. Save Report makes a zip in ~/Documents/AzaharFrame Reports to attach to an issue; check it before sharing. Send Report sends it to me. Nothing is sent unless you tap it.
- Full immersion mode: full 6DoF, with game-specific features.
- Nintendo DS and DSi support: through melonDS, with the Vulkan renderer from SapphireRhodonite's WatermelonDS and melonDS-android-lib.
- Dual-screen GBA: through kyannon's gba-ds, for Game Boy Advance play, with a map or status screen on the secondary screen in supported games.
- User guide
- Settings
- AGENTS.md: for developers and AI agents
- Building from source
- Changelog
If you want to support this app or my other Steam Frame ports, such as PrimedFrame, you can buy me a coffee.
- Azahar, which continues Citra: the emulator
- CitraVR by amwatson: the VR modes
- Qt, SDL, OpenXR: window, gamepad, VR
- astcenc by Arm: the texture pack encoder
- Frametop by DeeJanuz: the 3D mouse pointer is adapted from it
- Sharkive by FlagBrew, and my 3ds-game-fixes: the cheats
- Emerald 3DS by ZallaxDev, and CTGP-7 by PabloMK7: downloaded from their own sources
- Mods and texture packs: downloaded from their authors' own pages
- Azahar logo by angyartanddraw and PabloMK7; backgrounds by GarfieldGaming0624 on SteamGridDB
- Valve: SteamVR and the Frame
Full list: THIRD_PARTY_NOTICES.md. Not affiliated with Nintendo or Valve.
GPLv3 or any later version. See LICENSE.txt.
I started this project and used AI (Claude Opus 5.5) to speed up development. I write, review and fix code by hand all the way through, keep the AI's work checked and reined in, and aim to keep the port as lightweight as possible. I test it on my own Steam Frame.




