Azahar

Releases

• Jun 29, 2026 2125.1.3-vanilla
  This is an unscheduled release which almost exclusively addresses issues in the macOS version of Azahar. Primarily, it fixes an issue experienced by many users where Azahar could potentially freeze when opened. This issue didn't affect all users, and whether or not it appeared was dependent on multiple factors such as the macOS version being run and the macOS version Azahar was built with, and the current state of the user's Azahar directory. Because of this, it took some time to determine the root cause of the issue. Apologies for any inconvenience this may have caused for any affected users. --- # Azahar 2125.1.3 Changelog # macOS

  More…

  - Fixed an issue where Azahar could instantly freeze on boot depending on certain factors such as OS version and Azahar user data content. | @OpenSauce04 #2244 # Technical - Backported a fix for linker warnings when building with Discord rich presence on macOS, first introduced in 2126.0 Alpha 2. | @OpenSauce04 #2216 - The CMake option name change introduced in that PR has **not** been backported. - Introduced changes to dynarmic which fix a build issue introduced by MSYS2 package updates. | @PabloMK7 #2236
• Apr 21, 2026 2125.1.1-vanilla
  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

  More…

  - 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
• Apr 14, 2026 2125.1-vanilla
  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).

  More…

  - 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.
• Mar 26, 2026 2125.0.1-vanilla
  > [!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

  More…

  # 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: - [x] Linux (x86_64) - [x] Windows (x86_64) - [x] macOS (arm64) - [x] macOS (x86_64) - [x] Android (arm64) - [x] iOS - [x] 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](https://netpass.cafe/) 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 can now be both connected to hosted without the DLP LLE module, meaning that Download Play is now fully operational with HLE only. | @lannoene #1741 #1828 - Fix an issue where certain applications, such as Nintendo Video, would incorrectly think they were receiving SpotPass data. | @lannoene #1828 - Fixed an issue which could prevent .zcci and .zcxi ROMs from being recognized correctly if the 3DS system files hadn't been set up. | @PabloMK7 #1930 - Added a debug option which allows toggling the console type specified in the console unique data between the Old and New 3DS types. | @PabloMK7 #1826 - Addressed validation issues Vulkan renderer which could potentially have resulted in undefined behavior. | @PabloMK7 #1818 - Fixed Nintendo Badge Arcade incorrectly displaying an "update data has been applied" message. | @PabloMK7 #1845 - Version numbers have been moved to the end of the release files' filenames for easier readability. | @OpenSauce04 #1815 - Implemented `NAND RW`, `NAND RO`, and `NAND RO W` archives, allowing the use of applications which utilize these archives. | @PabloMK7 #1861 # Android - Fixed a crash when attempting to use still-image camera emulation. | @PabloMK7 #1892 - Fixed an issue where the emulator could erroneously pause after selecting a file for camera emulation. | @OpenSauce04 #1894 - Added a new "Hotkey Enable" button bind. This button can be used in button combinations to activate hotkeys. | #1464 - See the linked PR for a more detailed explanation. - Added new "Auto-Map Controller" button which functions similarly to its desktop equivalent. | @RJNY #1769 - Fixed a crash under certain circumstances when a secondary screen is disconnected. | @PabloMK7 #1903 - Fixed an issue where secondary screens could sometimes use the wrong aspect ratio. | @DavidRGriswold #1907 - Fixed multiple issues in the setup screen which could cause the setup process to crash or get stuck in a loop on certain Android distributions. | @PabloMK7 @OpenSauce04 #1902 - If the Applications button is double-clicked while already selected, it will now display the current Azahar version in a toast notification. | @OpenSauce04 #1891 - The drawer menu now always uses the layout appropriate for the current device orientation. | @DavidRGriswold #1473 - Fixed an instance of the word "cartridges" being misspelled as "cartidges". | @sks316 #1879 - Fixed an issue where applications would not display properly in the application list if its update title failed to load. | @PabloMK7 #1930 # Android (Vanilla) - Move to a new package ID, `org.azahar_emu.azahar`. | @OpenSauce04 #1874 - The Google Play variant still uses the old package ID, meaning that these two variants now how separate package IDs. - Migrated to a more consistently effective method of determining removable storage paths. | @PabloMK7 #1863 - Transition to using fully native file I/O for the Vanilla (non-GooglePlay) build variant. | @PabloMK7 @OpenSauce04 #1795 - This results in extreme reductions of loading time compared to previous builds or the current Google Play build. - As an example, booting the HOME menu has been observed to drop from taking 30-45 seconds to now taking under 5 seconds. - As explained in previous patch notes, these improvements don't apply to the Google Play build due to restrictions put in place by Google via their Play Store app policies. # Desktop - Implemented a setting which allows a controller touchpad to be used to control the emulated 3DS touchscreen. | @DavidRGriswold #777 - Fixed a rare issue where the emulator could attempt to pre-load custom textures even when they were disabled, resulting in a crash. | @coolguy1842 #1629 - Fixed an issue where a small subset of setting tooltips wouldn't have any automatic line breaks as intended. | @OpenSauce04 #1718 - Added new "Enable display refresh rate detection" debug setting. | @OpenSauce04 #1726 - This setting is enabled by default, and disabling it prevents Azahar from attempting to detect the display's refresh rate when choosing its preferred Vulkan presentation mode. Disabling this setting can result in emulation slowdowns with certain displays, so it's recommended to leave it enabled unless you know what you're doing. - Fixed an issue which could cause Azahar to crash when resetting all settings to their default value. | @ChaseParate #1751 - Removed all code relating to the old SDL2 frontend. | @OpenSauce04 #1756 - This is not to be confused with the SDL2 functionality present in the Qt frontend.<br>This exclusively refers to the SDL2 emulation frontend, which has been disabled at build time by default for ages. - Improved update checker logic to prevent potential downgrades caused by hypothetical future release patterns. | @RedBlackAka #1749 # Windows - Fixed camera emulation with a real camera not working as intended in the MSYS2 build. | @jbm11208 #1812 - Fixed filesystem issues with some games due to minor file I/O emulation inaccuracies. | @PabloMK7 #1841 - Fixed an issue where certain characters in an application name could become corrupted when creating a desktop shortcut. | @RedBlackAka - Explicitly tell AMD drivers to use the dedicated GPU by default if an integrated GPU is available. | @RedBlackAka #1783 # macOS - Added a warning message when launching Azahar directly rather than from the .app bundle informing users of the proper way of launching the app. | @OpenSauce04 #1873 - Fixed a possible UI freeze during game list population. | @TeamPuzel #1785 # Technical - If certain features are disabled at compile-time in the desktop build, code related to those features is now more aggressively excluded. | @RedBlackAka #1630 - Detection of CPUs using the FMA4 extension has been disabled, as this extension is not used by Azahar. | @RedBlackAka #1746 - Added NATVIS to BitField class, allowing for better debugging in Visual Studio. | @PabloMK7 #1731 - Remove redundant code relating to SSE4.2 CPU detection. | @RedBlackAka #1753 - Removed unused SSE/SSE2 CPU detection code. | @RedBlackAka #1754 - Intel macOS binaries are now built using macOS 26 + Xcode 26. | @OpenSauce04 #1803 - Refactor and fix a resource leak in the Vulkan texture runtime. | @PabloMK7 #1790 - This change is for correctness, and has no real effect on end-users. - Several emulation correctness fixes which have no real end-user impact. | @PabloMK7 #1839 #1846 #1860 - Improved CMake version info generation to avoid stale info being used and allow `GIT-TAG`/`GIT-COMMIT` to override real Git info for testing | @OpenSauce04 #1848 - Fixed a build failure on ARM64 Linux with GCC which has existed for an unknown period of time. | @OpenSauce04 @PabloMK7 #1872 - Fixed compilation failing when building with versions of Qt6 earlier than 6.7.0. | @cobalt2727 #1886 #1895