Azahar: baixar versions anteriors

This a minor release for the 2126 branch which primarily addresses a reported security advisory.
It also includes several newly backported improvements and fixes from the master branch.
Users are advised to update as soon as is convenient.
Azahar 2126.2 Changelog
All
- Addressed an oversight which allowed specially-crafted CIA files to execute arbitrary code in the host environment when locally installed by a user. | @PabloMK7 #2648
- Addresses the following GHSA report: GHSA-h74v-5mw8-qg8r
- Fixed an issue where the xBRZ texture filter would be applied incorrectly when using the Vulkan renderer, resulting in an incorrect appearance. | @OpenSauce04 #2647
- Handling of large HTTP downloads within emulated 3DS applications has been improved, improving memory efficiency and stability. | @PabloMK7 #2515
- Fixes downloading large games from the eShop.
- Added a new 3GX loader flag allow_homebrew_load, which allows loading 3GX plugins for homebrew apps if the plugin supports it. | @PabloMK7 #2649
Desktop
- Various improvements to GDB and RPC servers, fixing certain issues and improving functionality. | @PabloMK7 #2631, #2640, #2633
- For additional info, see individual PR descriptions.
- Script developers will need to update the RPC client as this is a breaking change.
Android
- Fixed a crash which could occur if the gpu_drivers directory contained a subdirectory. | @ygordreyer #2592
Technical
- Creating a copy of the kernel shared and config pages using svcMapProcessMemoryEx is now possible.
- This is a technical accuracy change. Little to no end-user impact.

This an unscheduled fix release which addresses a commonly experienced issue in Azahar's libretro cores.
For other versions of Azahar, this update is identical to 2126.1.1.
Azahar 2126.1.2 Changelog
libretro
- Fixed an issue which could cause RetroArch to entirely freeze or crash when exiting a game. | @Razor221 #2572

This an unscheduled fix release which addresses a few notable issues discovered post-launch in the 2126.1 update.
All users are encouraged to update as soon as is convenient.
Azahar 2126.1.1 Changelog
All
- Fixed an issue where Azahar could instantly crash when opened on certain systems with poor Vulkan support. | @Wunkolo #2528
- The "Skip Presenting Duplicate Frames" setting has now been disabled by default due to minor observed regressions compared to the old behaviour. | @PabloMK7 #2530, @OpenSauce04 #2536
- Fixed an issue which could cause Azahar's Vulkan renderer to crash when handling certain shadow textures. | @Wunkolo #2533
- Fixes a crash in Monster Hunter 4 Ultimate after opening the equipment menu.
Windows
- The About menu and Azahar's log file now indicate which build variant is currently being used (MXE, MSVC or MSYS2). | @OpenSauce04 #2538

Known Issue Notice
There is a minor known issue in the new MXE build for Windows where frame pacing may be slightly inconsistent. A potential fix for this issue has already been implemented, but requires additional testing. This fix will be included in the 2126.1 update.
Most users likely won't notice this issue, so use of the MXE build is still encouraged.
The MXE build will replace the MSYS2 build in 2127.0.
Thank you for your understanding.
Azahar 2126.0 Changelog
All
- Improved GPU interrupt queue & GPU timing emulation. This feature is highly experimental and is disabled by default, the toggle for it can be found in the graphics settings: "Simulate 3DS GPU timings". | @PabloMK7 #2095, #2145
- This change improves emulation accuracy by more closely mirroring the behaviour of real hardware.
- This PR is known to fix GPU timing issues in Luigi's Mansion 2: Dark Moon, which is now made playable without use of the "delay render thread" option, but likely impacts many other games as well.
- This PR also introduces a fix for an issue in Super Mario 3D Land which would prevent users from loading a save file after completing the game.
- This is a big change behind the scenes, and may inadvertently introduce issues due to its large scope. Please report any issues which may have been introduced by the new behaviour.
- Games that use dynamic FPS and don't reach 60 FPS on real hardware will also not reach 60 FPS on Azahar with this feature enabled.
- The PR description contains an in-depth technical explanation of the changes.
- Completely revamped the implementation of GDB functionality, with numerous debugging improvements and new debugging features. | @PabloMK7 #2086
- The PR description for this change goes into extensive detail about the changes, so read there for more information if curious.
- Refactored how filesystem access is handled for special files (such as Z3DS files), in preparation for changes coming in Azahar 2127. | @PabloMK7 #2352
- Fixes compressed 3DSX files (.z3dsx) with an embedded RomFS failing to load properly.
- Users should not expect any visible changes as this is only an internal restructuring of the code. If that is not the case please consider filing a bug report.
- NOTE: Due to internal changes on how system files are stored, system files set up on Azahar 2126 or newer will become incompatible with older Azahar versions. On the other hand, system files set up on versions older than Azahar 2126 will remain backwards compatible for the foreseeable future.
- More details on why this change is neccessary can be found in the pull request.
- Fixed an issue where screenshots produced by Azahar could have their colour channels swapped on certain platforms and system configurations. | @mal-cap #2170
- Added a setting to skip presenting duplicate frames, which is enabled by default. | @KojoZero #1867
- This makes frame generation software work properly with Azahar.
- Added a new option which allows users to toggle whether the emulated 3DS system thinks headphones are plugged in. | @PabloMK7 #2099
- A very small number of games have altered behaviour when using wired headphones. For example, when headphones are plugged in while playing Super Mario 3D Land, the audio playback is slightly altered.
- In multiplayer rooms, users' usernames are now pulled directly from the username set in the System tab in Azahar's settings instead of being a separate option.
- Fixed a crash which could occur when an application submits a vertex array with an invalid base address. | @PabloMK7 #2299
- Known to fix a crash in the credits of Mario & Luigi: Superstar Saga. May fix other problems elsewhere.
- Adjusted rom loading error messages displayed to users to be more easily understandable and user-friendly. | @PabloMK7 #2097
- LG2/EX2 subroutine functions are now only emitted for shaders when necessary, instead of for every shader, reducing memory usage. | @Wunkolo #2046
- Fixed an issue where certain older homebrew software would get

This is an unscheduled release to put into action new security policies we have enabled for Azahar after the recent TeamPCP supply chain attacks, which affected big open source projects like CEMU Emulator.
This release contains no user-facing changes when compared with 2125.1.1 outside of the security policy changes. We decided to publish this release now so that the new policies are applied as soon as possible. Users may choose to skip this release if they wish.
Please keep in mind that Azahar was NOT compromised by the attacks and our users are safe. We are just being proactive and adding security measures to our release distribution process as a preventative measure.
Azahar 2125.1.2 Changelog
All
- Enabled Attestation and Software Bill Of Materials for release assets to increase release security. | @PabloMK7 #2117
- From now on, Azahar releases are immutable. This means that once we publish a release, the assets linked to it cannot be changed in any way. This prevents token stealers from modifying release assets after they are published. You are able to know if a release is immutable if it shows a padlock icon with the word Immutable at the top left of the page.
- Starting from this release, Azahar release binaries are attested. This means that all of the official Azahar assets have now signed claims that specify where they were produced (CI jobs), the exact commit and timestamp, and other metadata.
- Users should be able to verify the validity of azahar binaries using the GitHub Cli. For example: gh attestation verify --owner azahar-emu --predicate-type "https://spdx.dev/Document/v2.3" <file-path>. This command will only succeed if the file was not tampered with, which is useful when downloading assets from secondary sources, such as our Internet Archive page.
- While plain sha256 hashes serve to verify integrity, attestations also allow to include the aforementioned metadata.
- You can view the attestations for all of our binaries in the Attestations page.
- Also starting from this release, Azahar binaries have a Sofware Bill Of Materials, which consists in a JSON that (in theory) contains all dependencies Azahar relies upon, which should help tracking vulnerabilities. In practice, this technology is rather new, so not all dependencies are fully detected. You can read more about this in #2117.
- A verify-release bash script is now provided in our source code that helps verifying the validity of Azahar releases. This allows users to better audit our releases as well as easily obtain the software bill of materials. Example usage is as follows: ./tools/verify-release.sh azahar-emu/azahar 2125.1.2. You can learn more about this tool in #2117.
Technical
- Added EXCLUDE_FROM_ALL to CMake targets where applicable, speeding up build times for certain non-standard build configurations. | @OpenSauce04 #2088
- All libretro core binaries are now stripped, greatly reducing filesize (primarily for the Android core) without affecting functionality in any way. | @OpenSauce04 #2111
- This is only relevant for the core binaries distributed by us; The cores used by the RetroArch core downloader were already doing this.

This is an unscheduled bugfix update which addresses previously undetected regressions in the 2125.0 and 2125.1 releases.
Users are advised to update when it is convenient to do so.
Azahar 2125.1.1 Changelog
Windows
- Fixed a regression introduced in 2125.1 where Azahar could appear to have rounded window corners while fullscreened. | @PabloMK7 #2049
All
- Fixed a regression introduced in 2125.0 where a small number of games could crash due to a shadow texture handling oversight. | @PabloMK7 #2047
Technical
- Changed a newly introduced use of the std::powf function in 2125.1 to use std::pow instead, restoring wider build environment compatibility. | @cobalt2727 #2045
- Miscellaneous OpenBSD build fixes. | @OpenSauce04 #2052

This is a minor release for the 2125 series which introduces bug fixes and some low-risk improvements + new features.
Azahar 2125.1 Changelog
All
- Added emulation of the 3DS's notification LED. | @PabloMK7 #2019
- Only the desktop frontend exposes this functionality as of now (see "Desktop" section).
- Fixed color blend modes behaving incorrectly on the OpenGL graphics backend. | @PabloMK7 #2038
- This notably fixes an issue where a black square could appear in the bottom-right corner of the screen in some games (e.g. Shin Megami Tensei IV)
- Implemented syscore CPU time limiting to match real hardware behaviour. | @PabloMK7 #1934
- Makes emulated applications properly use the syscore without starving LLE system applets, which fixes several subtle timing issues.
- Most notably, fixes stability issues caused by having the BOSS LLE module enabled.
- The BOSS LLE module is now enabled by the "Enable required LLE modules for online features" setting. | @PabloMK7 #1952
- Fixed emulated applications receiving incorrect error values from getaddrinfo/getnameinfo functions. | @GasInfinity #1956
- Optimize GeometryEmitter SETEMIT state, providing a minor performance improvement for games which use geometry shaders. | @Wunkolo #1996
Desktop
- Added a new UI element which displays the emulated 3DS's notification LED. | @PabloMK7 #2019
- Fixed Discord rich presence often not being set correctly due to a race condition. | @PabloMK7 #2035
- Removed Vulkan warnings which could appear at application launch on setups with missing Vulkan features. | @RedBlackAka #1938
- Removed Mesa OpenGL version override due to improved upstream support. | @RedBlackAka #1938
Android
- All builds of Azahar on Android, including the libretro core, now use the Vulkan renderer by default. | @OpenSauce04 #2003
- Note: On builds of Azahar other than the libretro core, this change doesn't apply retroactively to existing user configurations.
- Added a button to the about game dialog which allows deletion of disk shader cache on a per-game basis. | @PabloMK7 #2032
- Addressed an issue where orientation changes while a 3DS application is booting could cause the emulator to crash. | @PabloMK7 #2030
- Fixed an issue where hidden 3DS system titles could appear in the application list erroneously. | @PabloMK7 #1935
- Fixed an issue where, if a game was launched via an intent while another game was already open, the new game would be stuck infinitely loading. | @inssekt #2000
- Fixed an issue where resetting the values of the background color setting to the default would cause the app to crash. | @ptyfyre #1959
- Fixed application exits (e.g. with homebrew apps that close themselves) resulting in an "Invalid ROM Format" error dialog. | @SiniKraft #1991
libretro
- Fixed an issue where the libretro core could crash under certain circumstances when using the Vulkan renderer. | @warmenhoven #2004
Technical
- Added new ENABLE_BUILTIN_KEYBLOB CMake option, enabled by default. | @PabloMK7 #2024
- This is enabled by default for all of our builds, mimicking prior behaviour.
- Disabling it omits the built-in keys usually distributed with Azahar, which disables certain functionality.
- Added new USE_SYSTEM_OAKNUT CMake option. | @marcin-serwin #1947
- Improved logging for SVC failures. | @PabloMK7 #1948
- Our x86_64/Intel macOS binaries are now cross-compiled from an ARM64 macOS runner. | @OpenSauce04 #1953
- Fixed an issue where attempting to build Azahar's test suite alongside our libretro core while using GCC would result in a linker error. | @warmenhoven #2012
- Fixed several issues related to building and using Azahar on NetBSD. | @OpenSauce04 #1998
- Unit tests are now able to be discovered by IDEs via catch_discover_tests. | @Wunkolo #1997
- Correct the response of SendToOther in soc:U. | @GasInfinity #1929
- This is a correctness fix, and has no effect on the end-user.

Note
Pre-existing users of the Android vanilla variant should uninstall their current Azahar app before installing this new version, as the application ID has changed. No user data will be lost, and the same user directory just needs to be selected during setup.
The new application ID for vanilla is org.azahar_emu.azahar. Third-party emulator launchers may need to account for this change. The application ID for the Google Play Store variant remains unchanged.
This is to differentiate the Vanilla build from the Google Play version, preventing the Google Play Store from attempting to update it.
Azahar 2125.0 Changelog
libretro
- Azahar is now available as libretro/RetroArch cores for various OS platforms. | @warmenhoven #1215 + other PRs
- Below is a list of platforms with available cores in this initial release:
- Linux (x86_64)
- Windows (x86_64)
- macOS (arm64)
- macOS (x86_64)
- Android (arm64)
- iOS
- tvOS
- Other platforms and architectures may be added in subsequent releases.
- It's important to note that, due to restrictions around the use of JIT compilation on the App Store, the iOS and tvOS have JIT forcefully disabled by default* on those platforms. Disabling JIT has a big impact on performance, so emulation speed may be below 100% on devices other than those which have been released relatively recently.
- * For more information, read here: https://docs.libretro.com/guides/install-ios/#jit
All
- Implemented a disk shader cache for the Vulkan renderer in the form of .vkch files. | @PabloMK7 #1725 #1748
- These files keep track of compiled shaders so that there is no need to recompile them on subsequent application launches, which removes all stutter caused by shader compilation after the first playthrough of the application.
- Cache files can also be copied between your own devices to benefit from the reduced stutter.
- Implemented NWM_SOC::GetMACAddress, allowing applications which utilize it to function properly. | @PabloMK7 #1840
- This change allows using the NetPass homebrew application on Azahar.
- Greatly reduced CPU usage of Azahar while using Artic Base. | @keynote #1789
- Shader and pipeline compilation tasks are now handled by separate workers, improving parallelism and slightly reducing shader compilation stutter. | @PabloMK7 #1802
- Re-added texture filtering functionality while using the Vulkan renderer. | @jbm11208 #1675
- This feature was previously added in version 2124, but was subsequently removed in 2124.2 due to stability issues.
- This iteration should address the issues present in the previous implementation.
- Fixed an issue where, if a game with no cheats had its cheat list viewed or the game was launched, the cheats list for the previously loaded game would be erroneously used. | @Fs00 #1640
- Minor fixes to local play for Luigi's Mansion 1 and Download Play applications. | @lannoene #1690
- Minor optimization applied to the Vulkan renderer which slightly reduces its memory usage. | @PabloMK7 #1710
- Very minor optimization for log message filtering, effective when a large number of LOG_DEBUG messages are produced in a short time-frame. | @PabloMK7 #1773
- Implemented new "Integer Scaling" option. @DavidRGriswold #1400
- Added a new "Layouts to Cycle" setting, which allows users to select which layouts are cycled by the Cycle Layout/Toggle Layout hotkey. | @DavidRGriswold #1430
- Apply the selected texture filter to color surfaces, not just texture surfaces. | @PabloMK7 #1784
- Major refactor of configuration backend for all platforms, improving maintainability | @OpenSauce04 #1762
- This change is primarily a developer-facing one, but does somewhat affect end-users on Android by having the default config.ini file be dynamically generated and validated, meaning that keys which were missing in the default config file are now present. | @OpenSauce04 #1762
- CECD LLE module is now enabled by the "Enable required LLE modules for online features" setting. | @PabloMK7 #1842
- Download Play sessions 

Note
Currently, the MSYS2 binary for Azahar 2125.0 is not available. This is due to a compiler issue which was discovered last-minute before release, and the issue greatly affects emulator stability.
For now, users are advised to use the MSVC build. An MSYS2 build will be retroactively added to this release page when the issue has been resolved.
Note
Pre-existing users of the Android vanilla variant should uninstall their current Azahar app before installing this new version, as the application ID has changed. No user data will not be lost, and the same user directory just needs to be selected during setup.
The new application ID for vanilla is org.azahar_emu.azahar. Third-party emulator launchers may need to account for this change. The application ID for the Google Play Store variant remains unchanged.
This is to differentiate the Vanilla build from the Google Play version, preventing the Google Play Store from attempting to update it.
Azahar 2125.0 Changelog
libretro
- Azahar is now available as libretro/RetroArch cores for various OS platforms. | @warmenhoven #1215 + other PRs
- Below is a list of platforms with available cores in this initial release:
- Linux (x86_64)
- Windows (x86_64)
- macOS (arm64)
- macOS (x86_64)
- Android (arm64)
- iOS
- tvOS
- Other platforms and architectures may be added in subsequent releases.
- It's important to note that, due to restrictions around the use of JIT compilation on the App Store, the iOS and tvOS have JIT forcefully disabled by default* on those platforms. Disabling JIT has a big impact on performance, so emulation speed may be below 100% on devices other than those which have been released relatively recently.
- * For more information, read here: https://docs.libretro.com/guides/install-ios/#jit
All
- Implemented a disk shader cache for the Vulkan renderer in the form of .vkch files. | @PabloMK7 #1725 #1748
- These files keep track of compiled shaders so that there is no need to recompile them on subsequent application launches, which removes all stutter caused by shader compilation after the first playthrough of the application.
- Cache files can also be copied between your own devices to benefit from the reduced stutter.
- Implemented NWM_SOC::GetMACAddress, allowing applications which utilize it to function on Azahar. | @PabloMK7 #1840
- Greatly reduced CPU usage of Azahar while using Artic Base. | @keynote #1789
- Shader and pipeline compilation tasks are now handled by separate workers, improving parallelism and slightly reducing shader compilation stutter. | @PabloMK7 #1802
- Re-added texture filtering functionality while using the Vulkan renderer. | @jbm11208 #1675
- This feature was previously added in version 2124, but was subsequently removed in 2124.2 due to stability issues.
- This iteration should address the issues present in the previous implementation.
- Fixed an issue where, if a game with no cheats had its cheat list viewed or the game was launched, the cheats list for the previously loaded game would be erroneously used. | @Fs00 #1640
- Minor fixes to local play for Luigi's Mansion 1 and Download Play applications. | @lannoene #1690
- Minor optimization applied to the Vulkan renderer which slightly reduces its memory usage. | @PabloMK7 #1710
- Very minor optimization for log message filtering, effective when a large number of LOG_DEBUG messages are produced in a short time-frame. | @PabloMK7 #1773
- Implemented new "Integer Scaling" option. @DavidRGriswold #1400
- Added a new "Layouts to Cycle" setting, which allows users to select which layouts are cycled by the Cycle Layout/Toggle Layout hotkey. | @DavidRGriswold #1430
- Apply the selected texture filter to color surfaces, not just texture surfaces. | @PabloMK7 #1784
- Major refactor of configuration backend for all platforms, improving maintainability | @OpenSauce04 #1762
- This change is primarily a developer-facing one, but does somewhat affect end-users on Android by having the default config.ini file be

This update re-enables support for the .3ds extension, which was previously removed in Azahar's initial release.
We previously made this change as a clear motion to distance ourselves from the mass piracy that lead to the closure of Yuzu and Citra, however, we have now determined that this change is causing more harm than good.
We've noticed that the removal of the .3ds extension has caused unnecessary fragmentation in the 3DS emulation community. This led to the creation of dubiously safe forks, to which a portion of the Azahar userbase migrated. These forks used unsafe deployment practices, presented licensing concerns, and confused users as to whether the forks were part of the upstream Azahar project. These circumstances created an unhealthy open-source development environment, and we don't believe that this is in the best interest of the 3DS emulation scene.
Given that the removal of the .3ds extension was originally an act of project philosophy rather than a technical change, we don't want this decision to overshadow the very real leaps which have been made in Azahar over the last year. Because of this, we have decided that it's for the best of everyone that we revert the change.
It is important to note that support for encrypted ROMs is still disabled; This will not change for the foreseeable future. Unlike the .3ds extension, which is a matter of project philosophy, encrypted ROMs still present actual legal challenges that we do not want to take on.
We have decided to publish this change in its own Azahar release to avoid the change overshadowing additions made in the future 2125 update.
We hope that this change will help to bring the 3DS emulation community closer together.
Azahar 2124.3 Changelog
All
- Re-added support for the .3ds file extension. | @PabloMK7 #1701

Similarly to 2124.1, this minor release focuses on fixing high-priority bugs and issues.
Additionally, it introduces a new "Update Channel" feature on desktop builds, allowing you to receive in-app notifications for pre-release builds such as betas and release candidates, even when running a stable release. We are releasing this feature in the hope that it will encourage more users to try the prereleases, experiencing the new features early and helping us to polish the final release by reporting issues we may have missed.
Azahar 2124.2 Changelog
Desktop
- Introduced a new Update Channel feature | @OpenSauce04 #1659
- This feature can be accessed from the General section of the settings menu under a new "Updates" subsection.
- The available channels are "Stable" and "Prerelease".
- When using pre-release builds, update notifications will still be received for newer pre-releases regardless of the setting value to allow important fixes to be distributed. As such, this new feature primarily applies to the stable build.
- Added a note to the "Enable async presentation" setting indicating that it adds 1 frame of input lag. | @Immersion95 #1669
- The Vulkan texture filtering functionality, which was introduced in 2124, has been temporarily disabled due to unforeseen stability issues. | @PabloMK7 #1678
- This feature is planned to be re-enabled in the 2125 update following additional polishing and another round of public testing. Apologies for any inconvenience.
MacOS
- Fixed an issue where, when using an Application Directory, Azahar may hang or have a flickering user interface after launching. | @OpenSauce04 #1665
All
- Fixed an issue where plugins that were intended to run for all title IDs instead didn't run at all. | @OpenSauce04 #1679
- This notably fixes an issue where the Nimbus plugin required to play Animal Crossing: New Leaf online failed to load properly.
- Updated SDL to version 2.32.10. | @OpenSauce04 #1680
- This notably fixes an issue where connecting/disconnecting a controller during emulation on macOS would cause the emulator to crash.
- Fixed an issue where, when launching from the HOME menu, applications which required forced accurate multiplication wouldn't have it activated. | @PabloMK7 #1671
- Fixed an issue where, when loading a save state, accurate multiplication would be automatically and erroneously disabled until emulation was restarted. | @PabloMK7 #1671
- Fixed an issue where game graphics could momentarily appear broken after loading a save state. | @PabloMK7 #1672
- Fixed an issue where custom textures would be disabled after loading a save state until emulation was restarted. | @PabloMK7 #1672
- Mario & Luigi: Paper Jam now has forced accurate multiplication, improving compatibility. | @PabloMK7 #1671
Android
- Fixed an issue where, on many setups, the VSync setting could appear to be disabled, but was actually enabled. | @OpenSauce04 #1658
- This was addressed by properly disabling the VSync setting in these configurations, matching the setting's prior appearance.
- Fixed an issue where the Retroid Pocket screen attachment could function incorrectly on the Odin 2. | @DavidRGriswold #1667
- The circle pad/c-stick binding UI has been updated to be more clearly understandable. | @DavidRGriswold #1676
Technical
- CMake now explicitly searches for Qt6::GuiPrivate before linking with it, improving build compatibility in certain environments. | @marcin-serwin #1657

This minor release addresses high-priority issues which were discovered since the previous update.
Users, especially those using version 2124, are advised to update whenever it is convenient to do so.
Azahar 2124.1 Changelog
All
- Fixed a regression introduced in 2124 where, while using the Vulkan renderer, certain textures or graphical effects would have an incorrect appearance. | @jbm11208 #1634
Android
- Fixed a long-standing issue where, on certain Android flavours or devices, the Azahar app could instantly crash when opened. | @OpenSauce04 #1646
MacOS
- Fixed a regression introduced in 2124 where the Azahar application could immediately hang after launching on macOS 26 Tahoe. | @PabloMK7 #1649
Technical
- Fixed an issue where, when building locally, build information may sometimes not be generated correctly. | @OpenSauce04 #1652
- Upgraded bundled Qt to 6.9.3. | @OpenSauce04 #1650
- Removed a leftover file from the long-decommissioned Citra installer. | @OpenSauce04 #1651

It's been a while since the last major update, and we've been working hard during that time to bring many improvements to the emulator.
In fact, by a decent margin, this is Azahar's largest update ever!
Please take a look at the changelog below to see what we've been working on and learn about the new features which are available.
As previously announced and explained in an announcement on our Discord server, this release increases the minimum Android version from Android 9 to Android 10.
Devices running Android 9 will no longer be able to update beyond Azahar 2123.4.1.
See the announcement post for additional information.
Azahar 2124 Changelog
All
- Implemented emulated cartridge insertion functionality. | @PabloMK7 #1304
- This causes the cartridge to appear inserted on the emulated HOME menu, and otherwise act as an inserted cartridge would on real hardware.
- Implemented texture filtering while using the Vulkan renderer. | @jbm11208 #1116, @jbm11208 #1513, @PabloMK7 #1561
- Added support for secondary screen opacity while using the Vulkan renderer. | Briar @OpenSauce04 #1255
- Improved HLE NWM support. | @lannoene #1375
- This enables multiplayer functionality with use of the LLE DLP module in several new games, including Luigi's Mansion, Luigi's Mansion: Dark Moon, and Mario Kart 7.
- Implemented HLE DSP sleep and wakeup functionality. | @PabloMK7 #1529
- This fixes an issue where games could have bugged sound when opened from the HOME menu.
- Added new SMDH region free patch setting which is enabled by default. | @PabloMK7 #1541
- This functions similarly to the region free patch from Luma3DS.
- Improved memory mode handling, allowing extended memory games to be launched from the HOME menu. | @PabloMK7 #1534, @PabloMK7 #1560
- Improved plugin memory management, allowing launching applications with plugins from the HOME menu. | @PabloMK7 #1554
- Changed unimplemented GAS mode behaviour, fixing visual issues in the Monster Hunter games when a blur effect is used.
- Fixed garbled HOME menu graphics when suspending an application. | @PabloMK7 #1518
- Fixed a long-standing issue where microphone input could sound slowed-down or stuttery. | @PabloMK7 #1610
- Various improvements to stereoscopic 3D settings and functionality. | @DavidRGriswold #1212
- Implemented AM:CancelImportProgram, allowing emulated CIA installations to be cancelled mid-way. | @PabloMK7 #1535
- Improved implementation of MemorySystem::GetPhysicalPointer, resulting in a very minor performance improvement. | @PabloMK7 #1587
- Moved the plugin framebuffer address ownership from the plg:ldr service to the memory system, resulting in a very minor performance improvement. | @PabloMK7 #1572
- Fixed a possible crash in the Vulkan renderer caused by malformed geometry shaders. | @PabloMK7 #1585
- Switch to using xxHash instead of CityHash64 and improve ShaderSetup hashing behaviour, resulting in a minor performance improvement. | @PabloMK7 #1592
- Implemented game-specific fixes for broken geometry shaders in the following SEGA 3D Classics titles: Thunder Blade, After Burner, Power Drift.
- The play_time.bin file has now been moved from the log directory to the sysdata directory. | @OpenSauce04 #1310
Android
- Increased minimum Android version to Android 10. | @OpenSauce04 #1368
- Added support for compressing and decompression ROM files. | @ne-kle @PabloMK7 #1458
- Implemented background color, second screen opacity, and audio emulation settings from the desktop build. | marsia @rtiangha @OpenSauce04 #1254
- Fixed an issue where Discord could break secondary screen detection on dual-screen devices. | @DavidRGriswold #1455
- Added "Hide 3DS Images from Android" setting. | marsia @OpenSauce04 #1254
- This prevents images related to Azahar from showing up in the Android gallery.
- VSync is now disabled by default on Android due to reasons explained here. | @DavidRGriswold #1456
- This results in a noticeable reduction in input latency with little to no effect on the 

Azahar 2123.4 is an unscheduled minor release which primarily targets several critical issues which were discovered since the last release, some of which were caused by upstream changes.
All users are advised to update to this release at their earliest convenience.
Please read the change log for further details.
Work continues on the 2124 major release, and you can track its progress here.
New download options:
Android
- The Android build has been split into two new download options, those being the vanilla and googleplay builds.
- The vanilla version uses a new method of filesystem access which is significantly faster and more simple, but isn't permitted by the Google Play store due to its use of the MANAGE_EXTERNAL_STORAGE permission.
- This new system is in its infancy, and is mostly the same as the googleplay variant, so the performance improvements won't yet be apparent. Filesystem performance should noticeably improve in the next few major releases as more functionality is migrated to the new system.
- The googleplay version is compliant with Google Play Store regulations, and uses the old SAF-based method. This build will not see the performance improvements present in the vanilla build.
- Unless you have a particular reason to use the googleplay build or you are downloading the app from the Google Play Store, the vanilla version is recommended.
Linux
- The AppImage build has been split into two new download options, those being azahar.AppImage and azahar-wayland.AppImage
- The default azahar.AppImage now has native Wayland support disabled, instead opting to use XWayland when run in a Wayland session. This is due to some severe upstream issues that have been discovered when using native Wayland with Azahar (e.g. #1191)
- Users are advised to use the default AppImage unless they have a specific reason to have native Wayland support enabled, for example if they are running a system with no xwayland support.
Azahar 2123.4 Changelog
Desktop
- Fixed an issue where the emulator could instantly crash when starting an application due to a race condition. | @OpenSauce04 #1448
Android
- Fixed an issue where, if an application attempted to rename a file to a different location, the file wouldn't be moved, and the file would just be renamed in the same directory it was previously in. | @OpenSauce04 #1545
- This notably fixes an issue where Nimbus 2.x wouldn't install its files correctly.
- Implement new build variant which uses raw filesystem access for file I/O. | @OpenSauce04 #1511 #1542
Linux
- Fixed an issue where attempting to use the Vulkan renderer on a system with an AMD graphics card and Mesa 25.3.2 or later would result in an instant crash. | Anonymous contributor #1563
- Disabled native Wayland support in default AppImage, Create new AppImage download option with native Wayland support enabled. | @OpenSauce04 #1499
MacOS
- Fixed an issue where attempting to use a real camera for camera emulation would result in solid green video output from the camera. | @OpenSauce04 #1515
Technical
- Fixed a build failure in the AppImage build caused by an upstream change to linuxdeploy. | @OpenSauce04 #1486
- Added relWithDebInfoLite build profile. | @OpenSauce04 #1498
- Upgraded AGP to 8.13.1. | @OpenSauce04 #1500
- Updated Boost to v1.89.0 | @PabloMK7 #1502

Azahar 2123.3 primarily addresses issues experienced by users while using dual-screen Android devices. Additionally, minor changes were made to improve platform support.
Azahar 2123.3 Changelog
Android
- Various improvements to secondary display handling on Android. | @SapphireRhodonite @DavidRGriswold #1341
- Fixed an issue where, if a secondary screen was disconnected during emulation while using the Vulkan renderer, the emulator would still attempt to use the disconnected screen, causing various issues. | @DavidRGriswold #1371
Technical
- Our pre-built macOS binaries are now built using macOS 15 Sequoia + Xcode 16 for both x86_64 and ARM64. | @OpenSauce04 #1410
- Updated bundled fmt version to 12.0.0. | @OpenSauce04 #1411
- This fixes a compilation failure when attempting to build Azahar with Clang 21.

Azahar 2123.2 is a minor release for the 2123.x branch which primarily introduces changes to our build process to improve modern platform support.
It also addresses some minor issues which could be experienced while using the emulator.
Azahar 2123.2 Changelog
Android
- Fixed an issue where games may not close properly, and upon attempting to open a different game, the emulator would become stuck. | @DavidRGriswold #1357
- Fixed an issue where, upon attempting to edit a slider option with an out-of-bounds value, the emulator would crash. | @DavidRGriswold #1340
- Added native support for Android devices with 16kb memory pages. | @OpenSauce04 #1351
- Fixed an issue where the Logcat output would be spammed by log messages related to an abandoned BufferQueue. | @OpenSauce04 #1355
MacOS
- Fixed an issue where compilation would fail when using Xcode 26. | @OpenSauce04 #1338
- Fixed an issue where Qt widgets could appear corrupted when building using Xcode 26. | @OpenSauce04 #1352
- Updated to Qt 6.9.2. | @OpenSauce04 #1338
All
- Fixed an issue where, if the shaders/vulkan/ directory was manually deleted, the emulator would fail to recreate it properly, resulting in the emulator crashing due to failure to write cache data. | @OpenSauce04 #1373
- Users who encountered this issue will stop experiencing crashes after updating.
Windows
- Updated to Qt 6.9.2. | @OpenSauce04 #1338
Technical
- Fixed an issue where CMake configuration could fail if a bundled dependency was attempted to be used while the system also had a version of that dependency installed. | @OpenSauce04 #1342 #1377
- This was only ever observed on MacOS, but if it did exist on other platforms, this change will also fix those.
- Added a check for the required minimum Xcode version when building on MacOS. | @OpenSauce04 #1346
- Notably, this minimum doesn't align with our minimum MacOS version for running Azahar: When running Azahar, MacOS 13 Ventura is required, but when building Azahar, MacOS 14 Sonoma's Xcode 15 is required.

This release fixes a critical bug which affects all releases of Azahar from its initial 2120 release up to 2123.
Users of any version of Azahar prior to 2123.1 are advised to update as soon as possible.
Azahar 2123.1 Changelog
All
- Fixed a bug introduced in Azahar 2120 where, if an attempted installation of a .cia file failed, the save data of the associated game would be deleted. | @PabloMK7 #1319
- The logic flaw which allowed this to happen had been present in Citra for many years, but it was only able start to causing damage due to a seemingly innocuous adjustment which was made in Azahar's initial release.

Azahar 2123 Changelog
All
- Added ROM compression functionality. | @PabloMK7 #1208 #1249
- Support for the following new formats have been added: .zcia, .zcci, .z3dsx, .zcxi.
- ROMs can be compressed in Azahar using Tools --> Compress ROM File… on desktop.
- Fixed a memory leak in the AAC decoder. | @QidiWang #1167
- Fixed an issue where display refresh rates below ~60hz would cause emulation speed to be slower than intended when vsync was enabled. | @OpenSauce04 #1193, @kylon #1248
- Different 3DS applications now have separate Vulkan pipeline caches. | @PabloMK7 #1118
- Previously, all Vulkan pipeline caches were stored in a single large file which was shared between all 3DS applications.
- Fixed LCD colour fill functionality. | @PabloMK7 #1198
- Before being fixed, this could cause applications which fill the screen with a certain colour to be black or display garbage.
- When using the OpenGL renderer, if a shader fails to link, the emulator will now experience graphical anomalies and produce logs rather than crashing. | @PabloMK7 #1200
- Fixed some dead links left over from Citra. | @RedBlackAka #1250
Android
- Implemented secondary screen support for wired and wireless displays (Chromecast, Miracast). | @DavidRGriswold #617
- By default, this functionality is disabled, and must be enabled by setting Settings --> Layout --> Secondary Display Screen Layout to an option other that System Default (mirror).
- Added button sliding behaviour configuration to the Overlay Options menu. | @toksn #884
- Implemented play time tracking. | Kleidis, @rtiangha #813
- Restructured touch input code to correctly handle multitouch inputs, resulting in improved multitouch support for the on-screen controller overlay. | @OpenSauce04 #1296
MacOS
- Fixed an issue where the Artic Controller feature wouldn't work correctly on MacOS. | @AlexMolina08 #1263
- Fixed an issue where, on recent MacOS versions, enabling the OS’s low power mode would result in many games being limited to 50% emulation speed when vsync was enabled. | @OpenSauce04 #1193 #1262
- Added individual x86_64 and ARM64 binaries to releases alongside the existing universal download | @RedBlackAka #1138
Desktop
- Fixed horizontal centering being incorrect when using the single window or separate window layouts while fullscreened. | @DavidRGriswold #1211
- When using a prerelease build, users are now directed to download the update from the Azahar GitHub releases page rather than the Azahar website. | @OpenSauce04 #1295
- The Azahar website doesn't list prereleases, so this may have caused some confusion with users. This could have resulted in users unintentionally downgrading to the latest stable release.
- This doesn't affect stable releases such as this one, but it will affect all future prereleases.
Windows
- Minor adjustments to the Windows installer. | @RedBlackAka #1234
Technical
- Set correct stop flag in GSP. | @kynex7510 #1199
- Fix irq request register behaviour. | @PabloMK7 #1216
- This change and the previous one were noted to not affect 3DS applications at all in theory, instead being more of a correctness thing.
- Fixed compilation failing when building using GCC 13 or earlier. | @OpenSauce04 #1221
- Fixed a build error when using the USE_SYSTEM_GLSLANG CMake option. | @OpenSauce04 #1281, #1284
- Added a new CMake option USE_SYSTEM_SPIRV_HEADERS. | @OpenSauce04 #1281, #1284
- Removed use of deprecated boost class and moved to a functionally identical alternative. | @qr243vbi #1126
- Upgraded Vulkan-related dependencies to match Vulkan SDK 14.313.0. | @OpenSauce04 #1225
- Fixed the SDL frontend failing to compile due to the use of a removed function. | @OpenSauce04 #1190
- The SDL frontend still doesn’t work properly, and remains disabled by default at compile time.
- Various minor changes to the Azahar installer on Windows.
- Amended CMakeLists to help certain environments to find required Qt dependencies. | @qr243vbi #1165
- Upgraded Android Gradle Plugin to 8.11.1 | @O

This is a minor release for the 2122.x branch which implements several fixes and improvements.
Azahar 2122.1 Changelog
Android
- Fixed a long-standing issue where LTO would fail to enable during compilation | @PabloMK7 #1151
- Having LTO enabled allows the compiler to perform additional optimizations during compilation, resulting in a minor improvement to performance.
- This change increases the minimum CMake version for the Android build to 3.25.
- Fixed hotkeys bound to a button which causes the drawer to be opened triggering both the hotkey action and the opening of the drawer. | @kleidiss #1122
- An example of a button which would have previously caused this issue would be the Circle button on a Playstation controller, or the B button on an Xbox controller.
- Improved the layout of the initial setup process when in landscape orientation | @kleidiss #1123
All
- Fixed an issue where installation of a decrypted CIA could fail if encrypted content from an older Citra version | @PabloMK7 #1152
- Increased the size of the uniform buffer where it was previously too small | @PabloMK7 #1174
- This change improves performance for all applications, most prominently on Android devices when using the Vulkan renderer.
- Added a new "SWP" value to the advanced frametime information display which indicates the time spent in Renderer::SwapBuffers. | @PabloMK7 #1173
Technical
- Fixed an issue where building for Android would fail when using CMake 4.0 or later | @OpenSauce04 #1169

This update is notable for having a high number of improvements to game performance and compatibility. Please read the change notes.
Additionally, for x86_64 devices (most desktop computers), this update requires a CPU which has SSE4.2 instructions, and it is likely that all future releases will also have this requirement.
This feature is available in all modern CPUs released in 2011 or later.
The few users who have hardware which doesn't support this instruction set can compile the emulator from source with the ENABLE_SSE42 CMake option disabled.
Azahar 2122 Changelog
All
- SIMD operations have been used to optimize a commonly used function, reducing GPU processing time for all applications. | @PabloMK7 #1086
- This change breaks compatibility with x86_64 CPUs which don't have SSE4.2 instructions (primarily CPUs released before 2011).
- The few users who have hardware which doesn't support this instruction set can compile the emulator from source with the ENABLE_SSE42 CMake option disabled.
- Disabling this CMake option also disables the optimization to the commonly used function.
- Improved SVC handling timings by simulating the passage of time more accurately. | @PabloMK7 #1093
- This results in significant performance improvements for several games, including but not limited to Luigi's Mansion 2, Star Fox 64 3D, and The Binding of Isaac: Rebirth.
- Refactored state tracking in the video core, reducing the amount of needed syncs and uploads to the GPU. | @PabloMK7, anonymous contributor #1059
- This improves performance in all applications.
- Allow SPIR-V when using Shadow2D texture mapping. | @PabloMK7, anonymous contributor #1057
- This greatly reduces stuttering in some games. Games known to be affected by this include Luigi's Mansion 2 and Resident Evil: Revelations, but other games may also see improvements.
- GLSL -> SPIRV optimizations have been disabled by default, with a new setting added to re-enable them. | @PabloMK7 #1080, #1084
- Disabling these optimizations has minimal impact on performance while greatly improving stuttering in all applications.
- Fixed the start index parameter for the geometry shader config being set incorrectly. | @PabloMK7, anonymous contributor #1056
- This fixes an issue in Kid Icarus: Uprising where grind rails would appear to be invisible.
- Replaced a problematic assert in AccelerateTextureCopy with a logged error. | @PabloMK7 #1092
- This fixes an issue which caused The Binding of Isaac: Rebirth to immediately crash when starting a run.
MacOS
- Fixed an issue where certain entries would disappear from the native menubar while using certain non-English languages. | @RedBlackAka #1111
- Due to this change, the native menubar, which was disabled in 2121, has been re-enabled.
Android
- Additional options have been added during shortcut creation, allowing the icon and name of the shortcut to be customized. | Kleidis #824
- The performance overlay has been enhanced with new settings and statistics available to be toggled from the Layout settings. | Kleidis #808
- By default, only the current FPS is shown. Other statistics can be toggled on in the aforementioned settings menu.
- Added an aspect ratio setting which affects the single-screen layout. | @icy-briar #913
- Fixed a regression introduced in the 2122 prereleases where the Accurate Multiplication setting was tied to the value of the Asynchronous Shader Compilation setting. | @OpenSauce04 #1142
- Added an option which allows disabling JIT shader compilation. | @PabloMK7 #1085
- Reorganized the setup process to reduce the unnecessarily high number of pages. | Kleidis, @OpenSauce04 #820
- Added rotate screen upright toggle. | Kleidis #819
- Fixed an issue where Azahar would consistently crash on opening if it lost permission to access to the user data directory. | @PabloMK7 #1110
Desktop
- Added an option which allows advanced frame time information to be displayed at the bottom of the window. | @PabloMK7 #1083
- Fixed an issue where a

This is a minor update for the 2121.x branch which implements some minor improvements and fixes.
Azahar 2121.2 Changelog
All
- Added a setting which allows the RPC server to be toggled on and off. | @PabloMK7 #1047
- It was previously always on and is now disabled by default.
- Fixed an issue where the emulation framerate could become locked to the refresh rate of the monitor when emulation speed was set to unthrottled while using the Vulkan renderer. | @OpenSauce04 #1035
Android
- Fixed an issue introduced in Android 15 where emulation content would appear under the camera notch. | @OpenSauce04 #1069
- This fix will stop working in an unspecified future Android version. The property which fixes this issue was added in Android 15, but was then immediately deprecated in Android 16. A follow-up fix will be added down the line which addresses the issue in future Android versions.
- Fixed messages relating to the Turbo feature sometimes appearing in situations when the setting hadn't been modified (e.g. closing the settings menu). | @OpenSauce04 #1026
Room
- --username option now requires an argument where it was erroneously optional before. | @Kexanone #971
- This would result in a null pointer exception if an argument was not provided.
MacOS
- MoltenVK has been updated from v1.2.7-rc2 to v1.2.9. | @RedBlackAka #998
Technical
- Fixed a compilation error introduced in a recent MSYS2 update related to stat being used instead of _stat64. | @OpenSauce04 #1041
- Updated the prerelease update check code to use GitHub's tags API to get the latest tag instead of the releases API. | @OpenSauce04 #1076
- This avoids an issue where if several releases are uploaded in quick succession, the releases API may return the releases in the incorrect order, which would result in update checks either not prompting users to update or prompting users to downgrade depending on what version they were using.
- Added alpha and beta substrings to prerelease detection logic. | @OpenSauce04 #1074

This is a hotfix for the 2121 update which primarily addresses an issue relating to save states which wasn't caught during the release candidate period. Apologies if you were affected by the issue.
⚠️ Save states made on versions before this update are no longer compatible. Please read below for further information.
Azahar 2121.1 Changelog
All
- Fixed an issue where the emulator would crash when loading a save state while using the OpenGL renderer | @PabloMK7 #1016
- This change breaks backwards compatibility with save states made in Azahar version 2121 or earlier.
- Before updating to this version, please ensure that you have saved using the in-game save dialog.
- To avoid the above issue, this should be done while using the Vulkan renderer.
- For more information on how to appropriately use save states and avoid unexpected loss of progress, please read our blog post on the topic: https://azahar-emu.org/blog/understanding-save-states
Desktop
- Added a scroll bar to the Layout tab in the settings menu. | @SeppNel #1004
- This fixes an issue where, at certain screen resolutions, the height of the settings menu would be so tall that the Ok and Cancel buttons would be off of the bottom edge of the screen, and couldn't be clicked.

This is a minor update which irons out some final issues from our initial release.
If all goes to plan, this should be the last 2120.x release.
Thank you for your patience during our initial launch period.
We hope you look forward to the next major release, 2121.
You can see some of the improvements we've got in the pipeline for that release here.
Azahar 2120.3 Changelog
Android
- Added a new prompt for users who may have inadvertently selected a different user directory after upgrading from Lime3DS, making it seem that data such as saves may have been lost. | @DavidRGriswold #917
- This new prompt allows users to choose between continuing to use their new user directory or restoring their old one.
- Needing to reselect the user directory after the upgrade was not intentional and was the result of a bug.
- We apologize if you were affected by this issue and thought you had lost data.
All
- Fixed an issue where Korean, Chinese and Taiwanese 3DS systems would be unable to start any application that used the system font due to the missing open source font replacement (this included the system setup tool). | @PabloMK7 #920
- For now, the EUR/USA/JPN font will be used, but most glyphs will be replaced with question marks.
- This allows the setup process to be completed, albeit without being able to read the text.
- A font with the missing glyphs may be added at a later date.
- Fixed an issue where consoles which have had their regions modified via custom firmware would be unable to start the system setup process via the Azahar Artic Setup Tool. | @PabloMK7 @luigoalma #921
Desktop
- Updated bundled SDL2 version to fix an issue where Xbox controllers would need to be re-paired every time they were turned off. | @OpenSauce04 9500859
- The Azahar application now explicitly sets its own window icon. | @OpenSauce04 #892
- For most platforms this shouldn't change anything, but on Linux it is known to fix some app icon issues.
Technical
- Fixed compilation failing when attempting to build using Qt 6.9.0 or later. | @OpenSauce04 #898
- Fixed compilation failing when attempting to build for desktop with Discord support enabled while using CMake 4.0 or later. | @OpenSauce04 4b5b4a2
- Disabled MSVC warnings C4711 and C5045 to make compilation logs less obnoxious to look at. | @OpenSauce04 #893
- Neither of these warnings are important.
- The version of NSIS we use to build our Windows installers has been bumped from 3.10 to 3.11.

This another minor update similar to 2120.1 which aims to address some additional issues from the 2120 release.
It also implements a couple of minor improvements which were appropriate to include in this release.
Azahar 2120.2 Changelog
All
- After performing system file setup with the Azahar Artic Setup Tool, the virtual 3DS is now linked to the real 3DS which was used, and must be unlinked via the settings before setup is performed with a different console | @PabloMK7 #833
- Added several checks which verify that the country selected in the emulator settings matches up with the emulated region and the region of the console used to set up system files | @PabloMK7 #847
- Fixed a fatal error which could occur when playing games which do not have the same region as the emulated region while having LLE modules enabled | @PabloMK7 #806
- Fixed a memory leak which would be triggered when the virtual 3DS reads files | @SeppNel #750
Android
- Fixed an issue where audio output was unintentionally linked to the Audio Input setting, and the Audio Input setting did not work | @toksn #844
- Added Texture Sampling configuration option from the Qt frontend | @rtiangha #603
Technical
- Updated installed Linux filenames to use reverse TLD format | @OpenSauce04 #840
- To 99.9% of users this change will mean absolutely nothing, and is primarily a change in preparation for the Flatpak release

This update aims to address some issues which were discovered in the prior 2120 release.
If you were affected by these issues, thank you for your patience.