Skip to content

About

Azahar 3DS emulator with CitraVR's VR modes, running natively on the Steam Frame

Resources

Stars

5 stars

Watchers

1 watching

Forks

Repository files navigation

Azahar for Frame

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.

Azahar for Frame

Features

  • 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

3D and immersion

  • 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.

The VR menu

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

Cheats Install Mods Download Packs

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 and mod packs

  • 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.

Game-specific fixes

  • 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.

Experimental

  • 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.

Requirements

  • SteamOS Stable or Beta
  • A Steam Frame with about 500 MB of free storage
  • Your own 3DS games, dumped from your own console

Install

  1. Get the repository:

    git clone -b steam-frame https://github.com/simplysanatori/AzaharFrame.git
    cd AzaharFrame
  2. Download azaharframe-1.2.1-linux-arm64.tar.gz from Releases and install it:

    steam-frame/install.sh ~/Downloads/azaharframe-1.2.1-linux-arm64.tar.gz
  3. Launch Azahar for Frame from your Steam library.

Other installers:

Checksums and building: user guide.

First run

  1. Double-click the empty game list and select the folder with your games.
  2. Double-click a game to start it.

Keys and texture packs: user guide.

Controls

What each Frame button does in a game

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.

Update

Quit the emulator, then install the new tarball.

steam-frame/install.sh ~/Downloads/azaharframe-<version>-linux-arm64.tar.gz

Uninstall

Add --purge to also delete your settings, saves and keys. Your games are never touched.

steam-frame/uninstall.sh

Troubleshooting

  • The installer says Steam was not reachable: start Steam and run install.sh again.
  • 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.txt in ~/.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.

Reporting a problem

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.

Roadmap (planned)

  • 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.

More

Support

If you want to support this app or my other Steam Frame ports, such as PrimedFrame, you can buy me a coffee.

Credits

  • 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.

Licence

GPLv3 or any later version. See LICENSE.txt.

How this was made

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.

About

Azahar 3DS emulator with CitraVR's VR modes, running natively on the Steam Frame

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages