Skip to content

Releases

Azahar for Frame 1.2.1

Choose a tag to compare

@simplysanatori simplysanatori released this 17 Nov 20:13

Azahar for Frame 1.2.1

A fix for a crash in 1.2.0.

  • Fixed a crash when starting a game that has save states from an earlier version. In 1.2.0, such a game closed as soon as it started.

Download

  • azaharframe-1.2.1-linux-arm64.tar.gz: the release, for install.sh and Frametanium
  • azaharframe-1.2.1-framedrop-linux-arm64.zip and azaharframe.framedrop.json: the same release, for FrameDrop

Install

Download the tarball and run steam-frame/install.sh from the repository with it as the argument. You can also add simplysanatori/AzaharFrame in Frametanium, or install with FrameDrop. To update, run install.sh from the new release, or update in Frametanium. Your settings, saves and keys stay. The README has the steps and the main controls. The user guide has how to add your games, every control and every setting.

Known

  • Mario Kart 7's menus show white panels in Full (6DoF): Other Games mode.
  • An autosave pauses the game for about 0.2 to 0.5 seconds.

Reporting problems

Use Report a Problem: in the in-game menu under Settings > General > Help, or under Help in Azahar's window. You can also open an issue with what you did, what you expected and what happened, and attach launch.log and user/log/azahar_log.txt from ~/.local/share/AzaharFrame. They hold the paths of your games, which include your user name. Read them first.

Azahar for Frame 1.2.0

Choose a tag to compare

@simplysanatori simplysanatori released this 15 Nov 15:08

The biggest update yet, and maybe the biggest there will ever be.

A Mods tab, controls you can edit for any controller, mouse and pointer controls, screens you can detach, a keyboard in the headset, autosave and crash protection.

What's Different From 1.1

  • A complete redesign of every in-game menu, with Per-Game and Global settings and a new Position tab.
  • Settings is in three sections: General, Graphics and Immersive.
  • Homebrew is new: download 3DS homebrew directly from within the app.
  • Preload Custom Textures is off by default, and turning it on now asks first.
  • Azahar now runs under a memory limit. If a texture pack fills too much memory, memory leaks or anything else goes wrong, Azahar closes itself rather than freezing the Frame or crashing the headset.
  • Fast Forward's audio is fixed: it keeps its normal pitch. New Fast Forward Audio options: Sped Up, Normal Pitch, Normal Speed (Experimental) and Muted, on the VR Settings tab and in Configure > Audio, for one game or all.

Mods tab

  • New Mods tab in the VR menu, with Cheats, Mods and Textures.
  • Cheats: Download fetches the game's cheats from Sharkive and from my own repository.
  • Cheats, patches, mods and textures known to work on Azahar for Frame show a Verified chip after their name. My own picks show a check-mark badge instead, and are listed first, then the verified ones, then the most downloaded.
  • Cheats made for a different version of the game show which version. The version is the one the game itself shows, so Mario Kart 7 Ver. 1.2 and Fire Emblem Echoes 1.1 are no longer mistaken for other versions. A version that can't be read shows as Update Installed or the cartridge's revision.
  • I put cheats for another version of the game in a For Another Version section at the end of the list, closed until you open it. Its header says how many there are and how many are on.
  • Cheats, mods and texture packs from outside sources link to their author's page, for credit.
  • Mods: Install Mods lists mods for the game and downloads them straight from their authors' pages on GitHub, GameBanana, MEGA or Google Drive.
  • Each mod shows its author, version, downloads and date on one line.
  • When two mods conflict, you choose which one to use.
  • Texture packs have their own section in the VR menu. Download Packs downloads packs from their original sources, all within the app.
  • CTGP-7: with Mario Kart 7 open, the Mods tab has a CTGP-7 section. Install checks your Mario Kart 7 (version 1.2 update and save data), downloads CTGP-7's own installer from its official GameBanana page and runs it for you. Installing CTGP-7 takes about 5 minutes to complete. Afterwards it has Launch and Uninstall, and lists the mods that require CTGP-7 to run. Nothing of CTGP-7 is included or redistributed. CTGP-7 is made by PabloMK7 and the CTGP-7 team.

Texture packs

  • Several packs can be on at once, like Modern Pokemon Sprites on top of 5X Redrawn UI in Pokémon X and Y. I put the parts of every pack that's on in one list, Enabled Textures. When two change the same texture, the higher one wins, and Move Up and Move Down set the order. A pack made to go on top of another goes above it by itself.
  • Customize on a pack turns its parts on or off, such as characters or backgrounds. When two parts change the same texture, the one higher in the priority order wins.
  • Packs that come in variants install as one pack. You pick the variant on its Customize page.
  • Optimize for Frame converts a PNG pack to ASTC, which the Frame's GPU reads as it is. It is now on a pack's Customize page in the headset too.
  • The converter is built in (C++), so it needs no compiler. It uses Arm's astcenc.
  • Remove Original deletes the PNG pack once the optimized copy is in use.
  • A PNG pack over 1 GB suggests Optimize for Frame once.
  • In Flat, Customize Texture Pack... is in the game list's right-click menu, with the game's packs and their order at the top.

Crash protection

  • Azahar now runs under a memory limit. A texture pack that fills memory closes Azahar rather than freezing the headset. After an unexpected shutdown, the next start says Azahar Ran Out of Memory.
  • Running Low on Memory shows how many GB Azahar uses of its limit. Near the limit, the game pauses and offers Turn Off Custom Textures, Resume or Stop Game.
  • Turning on Preload Custom Textures asks first, with the pack's size, the memory in use and Azahar's limit. A pack too large for Preload Custom Textures loads as you play instead.
  • Holding Menu or View for 3 seconds stops a game that takes too long to start.

Save states

  • The first time you use save states, a message reminds you once that they are not a replacement for saving in the game.
  • Newer versions of Azahar won't load a save state made in an earlier version. I want to leave that choice to you, so Load Anyway still loads one. It backs up the game's save data first. If the game then closes unexpectedly, the next start offers Restore Save Data.
  • Restore backs up your current save data first, so newer progress is never lost.
  • Undo Load takes back a load from a slot or an autosave, until the game closes.
  • A save state that can't be read stops the game with a message, rather than crashing.
  • If a save state or Quick Save can't be written, a message says it could not be saved. The game keeps running, and the slot keeps the state it had.

Autosave

  • Autosave makes save states while you play. It is off by default. Turn it on in Settings > General.
  • It saves every 5 minutes, when you open the menu and when you close the game. Each game keeps its newest 3. Both can be set per game.
  • The autosave made when you open the menu has a spot of its own. It doesn't count toward the newest 3, so opening the menu never removes an older autosave.
  • Load State has an Autosave card with the newest one, and a list of the others.
  • "Autosaved" shows above the Primary Screen, or as a short message when that corner is out of view.
  • Autosaves wait while memory is nearly full, because writing one needs about 0.9 GB more for a moment.
  • In Azahar's window, autosaves are at the end of Emulation > Load State. The settings are in Emulation > Configure > General and in a game's Properties.

Settings

  • Settings, Controls and Position have a Global | Per-Game switch at the top right. The menu opens on Per-Game while a game runs. Choose Global to change every game.
  • Pointing at Per-Game while it is picked shows how many values on the tab are set for this game, for example "2 Per-Game Values Set".
  • Use Global Values for All, in the ⋮ menu next to the switch, puts the tab back on the global values.
  • Internal Resolution starts at 4x, as tested on the Frame. In previous versions it was Auto, which follows Azahar's window, so games drew at 1x in the headset (3x in the Full modes).
  • Bottom Screen Reticle, Reticle Speed, At Edge, Touchpad and Motion Controls can be set per game. Kid Icarus: Uprising starts with Bottom Screen Reticle on Headset and Motion Controls off, or with Angel's Aim when its mod is installed.
  • Accurate Image Copies, in Graphics, has three choices. Automatic, the default, fixes glitches only where a game needs it. On fixes more, but puts substantial stress on the GPU, and Off is the same as previous versions. Pointing at each choice in the headset or in Azahar's window explains it.

Crash reports

  • If Azahar closed unexpectedly, the next start says so, with the reason and the game that was running.
  • A What Were You Doing? prompt lets you add a note, typed on the VR keyboard.
  • See What's Sent shows the whole report. Save Report saves it as a zip you can attach to a GitHub issue. Send Report sends it straight to me, so I'm notified and can work on it right away.
  • Nothing is sent unless you tap Send Report, and then only that one report. It goes through Sentry, which I've set not to store IP addresses. Your user name and home folder are removed. The log can include the names and folders of your games.
  • Report a Problem sends any other problem the same way. It is in Settings > General > Help in VR, and under Help in Azahar's window, next to About Azahar for Frame.

Homebrew

  • The new Homebrew tab builds Pokémon Emerald 3DS from your own Pokémon Emerald ROM, dumped from a cartridge you own, and lets you play it.
  • Check for Updates looks for a new release when you ask.
  • If a newer Emerald 3DS release changes how its data is built so that Azahar for Frame can't build it itself, it asks first. Build With Emerald 3DS's Builder then runs the release's own builder in a protected sandbox that can only read your ROM and write its own folder. It remembers a yes for that version; Not Now asks again next time.

Controls

  • Edit Controls shows a New 3DS XL wire diagram.
  • Multiple gamepad, keyboard and mouse support. For example, use the left Frame controller and a mouse as a pointer in a game.
  • Bottom Screen Reticle: a controller or your head aims at the Secondary Screen, for games that aim with the touch screen. That controller shows no beam while it aims.
  • Aim Only While Pressed keeps the reticle in the middle of the screen until the trigger is pressed. Right Stick Moves Touch lets the right stick move the touch point too, instead of being the C-Stick, for more control in games with varied controls.

Angel's Aim (Alpha)

  • Angel's Aim brings Kid Icarus: Uprising into VR with Darkshade's C-Stick & Gyro mod. Aiming, on the Controls tab, is...
Read more

Azahar for Frame 1.1.1

Choose a tag to compare

@simplysanatori simplysanatori released this 11 Nov 02:35

Azahar for Frame 1.1.1

Sharper screens at high resolution, the game list on the controller, 3D depth per game, better stats placement and head motion controls.

  • At 5x resolution and above, the screens are sharp edge to edge. Valve's foveation layer lowered the detail away from where you looked; Azahar for Frame now turns it off.
  • The game list works with the controller, in VR and in Flat. The D-pad or the left stick moves through the games, and A pressed twice quickly starts the one you're on.
  • Double clicks with the beam are reliable.
  • 3D Depth is on the in-game menu's Settings tab, from 0% to 100%, for every game or just this one. It changes the 3D at once.
  • The stats appear in front of you and stay there, never behind a screen. Grip them to move them; the stick sets their distance and size.
  • Stats Position can put the stats on your left wrist instead. Turn your wrist toward your face to see them.
  • Motion Controls can use the headset: turn and tilt your head to aim.

Download

  • azaharframe-1.1.1-linux-arm64.tar.gz: the release, for install.sh and Frametanium
  • azaharframe-1.1.1-framedrop-linux-arm64.zip and azaharframe.framedrop.json: the same release, for FrameDrop

Install

Download the tarball and run steam-frame/install.sh from the repository with it as the argument. You can also add simplysanatori/AzaharFrame in Frametanium, or install with FrameDrop. To update, run install.sh from the new release, or update in Frametanium. Your settings, saves and keys stay. The README has the steps and the main controls. The user guide has how to add your games, every control and every setting.

Known

  • Mario Kart 7's menus show white panels in Full (6DoF): Other Games mode.

Reporting problems

Open an issue with what you did, what you expected and what happened, and attach launch.log and user/log/azahar_log.txt from ~/.local/share/AzaharFrame. They hold the paths of your games, which include your user name. Read them first.

Azahar for Frame 1.1.0

Choose a tag to compare

@simplysanatori simplysanatori released this 10 Nov 23:21

Azahar for Frame 1.1.0

A new in-game menu, curved screens, a side-by-side layout and live controls for immersive mode.

The in-game menu

  • Holding Menu opens a new menu with five tabs: Main, Position, Stats, Controls and Settings. It follows CitraVR's layout, in the style of Android XR.
  • Main: Continue, Quick Save, Quick Load, Save State and Load State (10 slots, with the time each was saved), Screenshot, Restart, Switch to Flat and Close Game.
  • Position: Reset Position, Swap Screens, Hide Bottom Screen, Screen Shape, Screen Layout, Screen Curve and Immersive Offset.
  • Stats: the frame rates and frame times from just before the pause.
  • Controls: the controller diagram, in game and for Azahar's window.
  • Settings: the VR settings, for every game or just this one. Rest the beam on a setting to see what it does.
  • Azahar's Window shows Azahar's own window over the game, for everything else. B goes back to the menu.

The screens

  • Screen Curve: the main screen can bend toward you like a curved monitor, from Off to 90° in 15° steps. The smaller screen stays flat, and touch still lands where the beam points.
  • Hold the screens with a grip and press D-pad up or down to change the curve. D-pad left or right still nudges them. To move them up or down, move your hand.
  • Screen Layout: Side by Side puts the smaller screen to the right of the main one, facing you. Stacked keeps it below. Hold the left stick click for 1 second to switch.
  • In Flat, the same hold cycles Large Screen, Side by Side and Default. So does a grip held with D-pad left or right.

Immersive mode

  • Wider View now has steps per game: Off, 1.1x, 1.2x, 1.3x and 1.4x. It shows more of the game around the edges.
  • Hold the immersive screen with a grip and press D-pad up or down to change it as you play. The screen grows with the view, so the picture keeps its scale.
  • D-pad left or right still shifts the screen for your lenses. To raise or lower it, move your hand.
  • Squeeze Width is now Narrow Screen, with a new 30% step.

Controls

  • Holding the right stick click for 1 second is the one reset. It puts the screens back and, in immersive mode, re-centres the view.
  • Quick Load needs the left bumper held for half a second, so a brush of the bumper never loads.
  • Grabbing the screens shows a short hint of what the D-pad and stick do.

Fixed

  • In Flat, dialogs such as Configure opened squeezed, with OK and Cancel off the bottom of the screen. They now fill the big screen and scroll.

Download

  • azaharframe-1.1.0-linux-arm64.tar.gz: the release, for install.sh and Frametanium
  • azaharframe-1.1.0-framedrop-linux-arm64.zip and azaharframe.framedrop.json: the same release, for FrameDrop

Install

Download the tarball and run steam-frame/install.sh from the repository with it as the argument. You can also add simplysanatori/AzaharFrame in Frametanium, or install with FrameDrop. To update, run install.sh from the new release, or update in Frametanium. Your settings, saves and keys stay. The README has the steps and the main controls. The user guide has how to add your games, every control and every setting.

Known

  • Mario Kart 7's menus show white panels in Full (6DoF): Other Games mode.

Reporting problems

Open an issue with what you did, what you expected and what happened, and attach launch.log and user/log/azahar_log.txt from ~/.local/share/AzaharFrame. They hold the paths of your games, which include your user name. Read them first.

Azahar for Frame 1.0.0

Choose a tag to compare

@simplysanatori simplysanatori released this 07 Nov 18:01

Nintendo 3DS games in VR, running natively on the Valve Steam Frame. Azahar for Frame is the Azahar emulator with the VR modes of amwatson's CitraVR, built for SteamVR and the Frame controllers. You need your own games; no game data is included.

Compared with CitraVR through Lepton and similar forks

  • It runs natively on the Frame. There is no Android layer, APK or adb.
  • It starts in under a second.
  • Far less work per frame. In Ocarina of Time 3D at 120 Hz with a 4K texture pack: 0.6 ms of CPU and 1.5 ms of GPU time, against 4.8 ms and 2.7 ms.
  • Less work for the chip means better battery life.
  • Texture packs load as ASTC with no stutter. CitraVR loads PNGs and stalls while it decodes them.

The emulator on the Frame

  • A native OpenXR app in the Frame's SteamVR, at 120 Hz, or 90 Hz if you prefer.
  • The release brings its own Qt and libraries. It runs on SteamOS Stable, Beta and Preview.
  • Play in VR on 3D screens, in immersive VR with head tracking, or flat on SteamVR's big screen.
  • Settings, saves, keys and shader caches are in one folder, ~/.local/share/AzaharFrame.

The screens

  • Grip a screen to move both. The stick of that hand moves them nearer or farther, and makes them bigger or smaller, up to 3 times: big enough to fill the whole view.
  • While you hold them, the D-pad nudges them half a degree at a time, for a big screen with an edge just out of view.
  • Tap the right stick click to swap the screens. Hold it for a second to put them back.
  • Tap the left stick click to hide or show the other screen.
  • Hide Bottom Screen, per game, for games that do not need it. Both bumpers and View bring it back.
  • Screen Shape, per game: 5:3, 16:9, 21:9, 4:3, 3:2 or 16:10, for mods and cheats that change the game's aspect. A change shows at once.
  • Background: black, or passthrough to see the room. The in-game menu has a button for it.

Immersive mode

  • Grip the immersive screen and move your hand to raise or lower it. The stick of that hand moves it nearer or farther, and makes it bigger or smaller.
  • The screen position is remembered for each game.
  • SteamVR's recenter (hold the Steam button) also re-centres the immersive view.
  • The default size keeps the HUD within the clear centre of the lenses. You can make the screen up to 2.5 times bigger.
  • While you hold it, the D-pad shifts it half a degree at a time. Immersive Offset is global, since it corrects for small differences in each user's IPD.
  • Wider View, per game, shows more of the game around a bigger screen.
  • Squeeze Width, per game, makes the screen 10 or 20% narrower, to bring HUD elements at the sides into view.
    • In future updates I may extend this, or add game-specific cheats or mods that move the HUD.
  • Immersive Game FOV, per game, for mods that change the game's field of view. A change shows at once.
  • Mario Kart 7, Super Mario 3D Land and Asphalt 3D start in Full (6DoF) mode, set up for each game.

Controls

  • The Steam Frame controllers, with the real D-pad.
  • The face buttons go by position, as on a 3DS. Face Buttons switches them to by label.
  • A trigger aimed at the bottom screen is a touch. Anywhere else it is ZL or ZR. Each hand decides on its own.
  • Hold View, then the right bumper, to Quick Save. Hold View, then the left bumper, to Quick Load.
  • Hold View, then pull the right trigger, to turn Fast Forward on or off. "Fast Forward" or "Normal Speed" shows for 2 seconds.
  • Hold Menu for a second to open the in-game menu: Azahar's window over the paused game. It has Quick Save, Quick Load and Passthrough buttons.
  • Hold View for 1.5 seconds to stop the game.
  • The right controller is the 3DS's gyroscope, for games that aim by moving the 3DS.
  • A Controls panel shows both controllers, with a line from each button to what it does. It has a page for the game and one for Azahar's window.
  • A Stats panel shows the frame rate, the emulation speed and the frame times.
  • The Frame controllers show in your hands, with soft beams that fade when you put them down.
  • The layout is a controls profile in Azahar's window, so you can change it.

VR and Flat

  • Press both bumpers, View and Menu to switch between VR and a flat window. The game keeps running.
  • In Flat, Azahar's window sits on SteamVR's big screen, the theater. It stays there when you close the dashboard.
  • In Flat the controllers work as in VR, with the same holds and combos. A tap of View or Menu is still Select or Start.
  • In Flat the window is 16:9, so it fills the big screen with no bars at the sides.
  • In Flat, hold Menu for a second to open the Flat menu: the game pauses and the window leaves Fullscreen with its menu bar, so the pointer reaches Azahar's menus and settings. Hold Menu again, press B or select Emulation > Continue to go back.
  • In Flat the stick clicks change the window's layout. Tap the right one to swap the screens and the left one to show only one screen. Hold the right one to go back to Large Screen, one big screen and one small, which is where Flat starts. VR keeps your own layout.
  • The next start uses the mode you used last.

Texture packs

  • Optimize Texture Pack for Frame in the game list converts a PNG pack to ASTC, so it loads with no stutter.
  • Use Original Texture Pack switches it back to how it was before.
  • Packs that ship DDS or KTX files keep their own mip levels.

Install

  • An installer that adds the library entry with its art, names the SteamVR dock entry, and sets SteamVR to 120 Hz with no motion smoothing. It sets them again at every launch.
  • install.sh --dry-run shows what it would do first.
  • Installing again updates the same entry. Your settings, saves and keys stay.
  • It installs and updates through Frametanium and FrameDrop too.
  • An uninstaller, with --purge for your data.

From Azahar and CitraVR

  • The emulation, the game list and the settings are Azahar 2127.0-alpha4's, and the 3D screens and immersive modes are CitraVR's. Thanks to the Azahar team and amwatson.

Download

  • azaharframe-1.0.0-linux-arm64.tar.gz: the release, for install.sh and Frametanium
  • azaharframe-1.0.0-framedrop-linux-arm64.zip and azaharframe.framedrop.json: the same release, for FrameDrop

Install

Download the tarball and run steam-frame/install.sh from the repository with it as the argument. You can also add simplysanatori/AzaharFrame in Frametanium, or install with FrameDrop. An update keeps your settings, saves and keys. The README has the steps and the main controls. The user guide has how to add your games, every control and every setting.

Known

  • Mario Kart 7's menus show white panels in Full (6DoF): Other Games mode.

Reporting problems

Open an issue with what you did, what you expected and what happened, and attach launch.log and user/log/azahar_log.txt from ~/.local/share/AzaharFrame. They hold the paths of your games, which include your user name. Read them first.