# Azahar patch notes

> A Nintendo 3DS emulator continuing from Citra, built by former Citra developers.

- Vendor: Azahar
- Category: Games
- Platforms: Desktop, Android
- Official site: https://azahar-emu.org
- Tracked by: What's New (https://whatsnew.fyi/product/azahar)
- Harvested from: GitHub (azahar-emu/azahar)
- Entries below: 11 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### 2126.0 — Azahar 2126.0

- Date: 2026-08-10
- Version: 2126.0
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0
- Permalink: https://whatsnew.fyi/product/azahar/releases/2126.0
- Labels: Platforms: Desktop, Android

- **changed** — Improved GPU interrupt queue and GPU timing emulation with a new experimental feature that can be toggled in graphics settings as 'Simulate 3DS GPU timings'
- **changed** — Completely revamped the implementation of GDB functionality with numerous debugging improvements and new debugging features
- **changed** — Refactored how filesystem access is handled for special files in preparation for future changes
- **fixed** — Fixed compressed 3DSX files with an embedded RomFS failing to load properly
- **fixed** — Fixed an issue where screenshots could have their colour channels swapped on certain platforms and system configurations
- **added** — Added a setting to skip presenting duplicate frames, which is enabled by default
- **added** — Added a new option to toggle whether the emulated 3DS system thinks headphones are plugged in
- **changed** — In multiplayer rooms, users' usernames are now pulled directly from the username set in the System tab instead of being a separate option
- **fixed** — Fixed a crash which could occur when an application submits a vertex array with an invalid base address
- **changed** — Adjusted rom loading error messages to be more easily understandable and user-friendly
- **changed** — LG2/EX2 subroutine functions are now only emitted for shaders when necessary, reducing memory usage
- **fixed** — Fixed an issue where certain older homebrew software would get stuck on a black screen at boot
- **changed** — Migrated many non-English language translations to simplified language codes for more consistent system language detection
- **fixed** — Fixed an issue related to disabled cubemap texture units
- **fixed** — Adjusted the unimplemented gas stub behaviour for the Vulkan renderer, fixing a graphical issue in Monster Hunter games
- **fixed** — Fixed a possible integer overflow issue relating to custom Luma3DS mapping
- **added** — Implemented APT:MapProgramIdForDebug
- **fixed** — Fixed handling of APT communication between applications
- **fixed** — Fixed behaviour of HTTPC:GetRequestState when the request still has pending post data
- **added** — Added an API to allow applications to register and unregister URL replacements

###### 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](https://github.com/azahar-emu/azahar/issues).
    - **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 emitt

_[Truncated at 4000 characters — full notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0]_

### 2126.0-rc5 — Azahar 2126.0 Release Candidate 5

- Date: 2026-07-28
- Version: 2126.0-rc5
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0-rc5
- Permalink: https://whatsnew.fyi/product/azahar/releases/2126.0-rc5
- Labels: Pre-release; Platforms: Desktop, Android

- **fixed** — Fix compressed 3DSX files (.z3dsx) with an embedded RomFS failing to load properly
- **changed** — Refactor how filesystem access is handled for special files such as Z3DS files in preparation for changes in Azahar 2127
- **fixed** — Fix an issue where the "Old 3DS setup" and "New 3DS setup" labels were erroneously swapped in the Set Up System Files menu

<h3>⚠️Important Release Candidate Information⚠️</h3>
<details>
<summary>
	This is a release candidate. Please expand this drop-down to read more about what this means before installing.
</summary>
<br>
As a release candidate, this build is not yet considered a stable release, but is instead a build which could be promoted to a stable release if it is sufficiently tested with no major issues being discovered. Ideally, the release candidate period will last for 7 days, however if major issues are discovered, this will be extended to allow for additional testing with a corrected release candidate.
<br><br>
Despite its status as a pre-release build, users are encouraged to test this version to help us catch any newly introduced issues before the build is promoted to a full release. If you do observe such issues, please report them to us on GitHub so we can evaluate them.
<br><br>
If you are unwilling to tolerate potential minor issues, you may be better off waiting until a release candidate is promoted to a full release.
<br><br>
Users are advised to back up their Azahar user data directory before using a pre-release build.
</details>

---

> [!NOTE]
> This changelog is relative to 2126.0-rc4. You can find the previous changelog [here](https://github.com/azahar-emu/azahar/releases/tag/2126.0-rc4).

---

#### Azahar 2126.0-rc5 Changelog

#### All

- 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](https://github.com/azahar-emu/azahar/issues).
    - **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.

#### Desktop

- Fixed an issue where the "Old 3DS setup" and "New 3DS setup" labels were erroneously swapped in the Set Up System Files menu. | @OpenSauce04 #2351

### 2126.0-rc4 — Azahar 2126.0 Release Candidate 4

- Date: 2026-07-25
- Version: 2126.0-rc4
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0-rc4
- Permalink: https://whatsnew.fyi/product/azahar/releases/2126.0-rc4
- Labels: Pre-release; Platforms: Desktop, Android

- **fixed** — Fixed a crash which could occur when using a controller which has a physical touchpad (e.g. PlayStation controller)
- **fixed** — Fixed an issue where having a PS4/PS5 controller connected could cause Azahar to hang when launched
- **fixed** — Fixed an issue where auto-mapping could behave incorrectly with some controllers
- **fixed** — Fixed assorted minor issues relating to analog input
- **fixed** — Fixed an issue where analog inputs for certain controllers could be incorrectly centered, fixing an issue on the Steam Deck where the L and R triggers were stuck pressed down
- **fixed** — Fixed an issue relating to clearing bindings for hotkeys bound to controllers
- **changed** — Slightly adjusted tooltip for "Disable Right Eye Rendering" setting for increased clarity
- **fixed** — Fixed a typo in the multiplayer room join message

<h3>⚠️Important Release Candidate Information⚠️</h3>
<details>
<summary>
	This is a release candidate. Please expand this drop-down to read more about what this means before installing.
</summary>
<br>
As a release candidate, this build is not yet considered a stable release, but is instead a build which could be promoted to a stable release if it is sufficiently tested with no major issues being discovered. Ideally, the release candidate period will last for 7 days, however if major issues are discovered, this will be extended to allow for additional testing with a corrected release candidate.
<br><br>
Despite its status as a pre-release build, users are encouraged to test this version to help us catch any newly introduced issues before the build is promoted to a full release. If you do observe such issues, please report them to us on GitHub so we can evaluate them.
<br><br>
If you are unwilling to tolerate potential minor issues, you may be better off waiting until a release candidate is promoted to a full release.
<br><br>
Users are advised to back up their Azahar user data directory before using a pre-release build.
</details>

---

> [!NOTE]
> This changelog is relative to 2126.0-rc3. You can find the previous changelog [here](https://github.com/azahar-emu/azahar/releases/tag/2126.0-rc3).

---

#### Azahar 2126.0-rc4 Changelog

#### All

- Fixed a crash which could occur when using a controller which has a physical touchpad (e.g. PlayStation controller). | @DavidRGriswold #2314 #2346
- Fixed an issue where having a PS4/PS5 controller connected could cause Azahar to hang when launched. | @DavidRGriswold #2345
- Fixed an issue where auto-mapping could behave incorrectly with some controllers. | @DavidRGriswold #2317
- Assorted minor fixes relating to analog input. | @DavidRGriswold #2348

#### Linux

- Fixed an issue where analog inputs for certain controllers could be incorrectly centered. | @DavidRGriswold #2328 
  - This fixes an issue on the Steam Deck where the L and R triggers were stuck pressed down. May also fix issues with other controllers.

#### Desktop

- Fixed an issue relating to clearing bindings for hotkeys bound to controllers. | @DavidRGriswold #2325
- Slightly adjusted tooltip for "Disable Right Eye Rendering" setting for increased clarity. | @72374 #2284

#### Android

- Fixed a typo in the multiplayer room join message. | @OpenSauce04 #2326

### 2126.0-rc3 — Azahar 2126.0 Release Candidate 3

- Date: 2026-07-14
- Version: 2126.0-rc3
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0-rc3
- Permalink: https://whatsnew.fyi/product/azahar/releases/2126.0-rc3
- Labels: Pre-release; Platforms: Desktop, Android

- **added** — When using multiplayer rooms, it is now possible to set "No Preference" as the preferred game
- **fixed** — Fixed crashes when creating or joining private multiplayer rooms on Android when the preferred game option is left untouched
- **fixed** — Fixed a crash which could occur when an application submits a vertex array with an invalid base address
- **fixed** — Fixed a crash caused by a missing eShop applet title ID, affecting some applications
- **fixed** — Fixed the Outer Right Camera setting incorrectly reading its value from the Inner Camera Flip setting
- **changed** — Updated NDK used to build Android libretro core to r27d
- **changed** — Changed all internal references to azahar_libretro to instead refer to citra_libretro to follow pre-existing project convention
- **added** — Azahar's build process now recognizes the new environment variable CITRA_USE_TAG_AS_VERSION, which when defined sets the Azahar version string to the output of git describe --tags --dirty

<h3>⚠️Important Release Candidate Information⚠️</h3>
<details>
<summary>
	This is a release candidate. Please expand this drop-down to read more about what this means before installing.
</summary>
<br>
As a release candidate, this build is not yet considered a stable release, but is instead a build which could be promoted to a stable release if it is sufficiently tested with no major issues being discovered. Ideally, the release candidate period will last for 7 days, however if major issues are discovered, this will be extended to allow for additional testing with a corrected release candidate.
<br><br>
Despite its status as a pre-release build, users are encouraged to test this version to help us catch any newly introduced issues before the build is promoted to a full release. If you do observe such issues, please report them to us on GitHub so we can evaluate them.
<br><br>
If you are unwilling to tolerate potential minor issues, you may be better off waiting until a release candidate is promoted to a full release.
<br><br>
Users are advised to back up their Azahar user data directory before using a pre-release build.
</details>

---

> [!NOTE]
> This changelog is relative to 2126.0-rc2. For a more complete picture of what will be included in the 2126.0 update, see [the previous changelog](https://github.com/azahar-emu/azahar/releases/tag/2126.0-rc2).

---

#### Azahar 2126.0-rc3 Changelog

#### All

- When using multiplayer rooms, it is now possible to set "No Preference" as the preferred game. | @PabloMK7 #2296
  - Also fixes crashes when creating or joining private multiplayer rooms on Android when the preferred game option is left untouched.
- 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.
- Fixed a crash caused by a missing eShop applet title ID, affecting some applications. | @PabloMK7 #2293

#### Desktop

- Fixed the Outer Right Camera setting incorrectly reading its value from the Inner Camera Flip setting. | @PabloMK7 #2303

#### Technical

- Updated NDK used to build Android libretro core to r27d. | @cscd98 #2298
- Changed all internal references to `azahar_libretro` to instead refer to `citra_libretro` to follow pre-existing project convention. | @OpenSauce04 #2304 
  - The compiled library filename remains unchanged: `azahar_libretro.*`.
- Azahar's build process now recognizes the new environment variable `CITRA_USE_TAG_AS_VERSION`, which, when defined, sets the Azahar version string to the output of: `git describe --tags --dirty`. | @OpenSauce04 #2302

### 2126.0-rc2 — Azahar 2126.0 Release Candidate 2

- Date: 2026-07-11
- Version: 2126.0-rc2
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0-rc2
- Permalink: https://whatsnew.fyi/product/azahar/releases/2126.0-rc2
- Labels: Pre-release; Platforms: Desktop, Android

- **changed** — Improved GPU interrupt queue and GPU timing emulation with a new experimental toggle in graphics settings called Simulate 3DS GPU timings
- **changed** — Completely revamped the implementation of GDB functionality with numerous debugging improvements and new debugging features
- **fixed** — Fixed an issue where screenshots could have their colour channels swapped on certain platforms and system configurations
- **added** — Added a setting to skip presenting duplicate frames, which is enabled by default
- **added** — Added a new option to toggle whether the emulated 3DS system thinks headphones are plugged in
- **changed** — In multiplayer rooms, users' usernames are now pulled directly from the username set in the System tab in Azahar's settings
- **changed** — Adjusted rom loading error messages to be more easily understandable and user-friendly
- **changed** — LG2/EX2 subroutine functions are now only emitted for shaders when necessary, reducing memory usage
- **fixed** — Fixed an issue where certain older homebrew software would get stuck on a black screen at boot
- **changed** — Migrated many non-English language translations to simplified language codes for more consistent system language detection
- **fixed** — Fixed an issue related to disabled cubemap texture units
- **fixed** — Adjusted the unimplemented gas stub behaviour for the Vulkan renderer, fixing a graphical issue in Monster Hunter games
- **fixed** — Fixed a possible integer overflow issue relating to custom Luma3DS mapping
- **added** — Implemented APT:MapProgramIdForDebug
- **fixed** — Fixed handling of APT communication between applications, fixing an issue in the Miiverse posting applet
- **fixed** — Fixed behaviour of HTTPC:GetRequestState when the request still has pending post data
- **added** — Added an API to allow applications to register and unregister URL replacements
- **fixed** — Fixed a crash on color fill when using the Vulkan Renderer
- **changed** — Disabled PICA debug functionality on all platforms with it now being a configurable option
- **fixed** — Fixed an issue related to fill surface downloading which could cause graphical bugs in edge cases

<h3>⚠️Important Release Candidate Information⚠️</h3>
<details>
<summary>
	This is a release candidate. Please expand this drop-down to read more about what this means before installing.
</summary>
<br>
As a release candidate, this build is not yet considered a stable release, but is instead a build which could be promoted to a stable release if it is sufficiently tested with no major issues being discovered. Ideally, the release candidate period will last for 7 days, however if major issues are discovered, this will be extended to allow for additional testing with a corrected release candidate.
<br><br>
Despite its status as a pre-release build, users are encouraged to test this version to help us catch any newly introduced issues before the build is promoted to a full release. If you do observe such issues, please report them to us on GitHub so we can evaluate them.
<br><br>
If you are unwilling to tolerate potential minor issues, you may be better off waiting until a release candidate is promoted to a full release.
<br><br>
Users are advised to back up their Azahar user data directory before using a pre-release build.
</details>

---

> [!NOTE]
> 2126.0-rc1 was reuploaded as 2126.0-rc2 to address a critical stability issue affecting the Android build.

---

#### Azahar 2126.0-rc2 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.
- 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.
- 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 stuck on a black screen at boot. | @Masamune3210 #2143
- Migrated many of our non-English language

_[Truncated at 4000 characters — full notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0-rc2]_

### 2125.1.3 — Azahar 2125.1.3

- Date: 2026-06-29
- Version: 2125.1.3
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2125.1.3
- Permalink: https://whatsnew.fyi/product/azahar/releases/2125.1.3
- Labels: Platforms: Desktop, Android

- **fixed** — Fixed an issue where Azahar could instantly freeze on boot depending on certain factors such as OS version and Azahar user data content on macOS
- **fixed** — Backported a fix for linker warnings when building with Discord rich presence on macOS
- **fixed** — Introduced changes to dynarmic which fix a build issue introduced by MSYS2 package updates

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

- 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

### 2126.0-alpha2 — Azahar 2126.0 Alpha 2

- Date: 2026-06-17
- Version: 2126.0-alpha2
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0-alpha2
- Permalink: https://whatsnew.fyi/product/azahar/releases/2126.0-alpha2
- Labels: Pre-release; Platforms: Desktop, Android

- **fixed** — Fixed incorrect system language detection in Azahar resulting in unexpected UI language
- **changed** — Translated many default Qt messages (OK, Cancel, etc) for most languages
- **changed** — Forcefully enable Vulkan renderer on Android devices using ANGLE for OpenGL rendering due to visual defects
- **changed** — Added improvements and new options relating to secondary screen functionality on Android
- **fixed** — Fixed an issue where certain older homebrew software would get stuck on a black screen at boot
- **changed** — Migrated non-English language translations to simplified language codes for more consistent system language detection
- **fixed** — Fixed an issue related to disabled cubemap texture units in Brain Age: Concentration Training
- **fixed** — Adjusted unimplemented gas stub behaviour for Vulkan renderer, fixing graphical issues in Monster Hunter games
- **fixed** — Fixed a typo in a settings log message
- **changed** — Additional refinements relating to the new GDB implementation
- **fixed** — Fixed a possible integer overflow issue relating to custom Luma3DS mapping and optimized implementation
- **added** — Distribute an ARM64 Docker image binary
- **fixed** — Fixed several minor issues relating to MoltenVK/Metal on macOS
- **changed** — Renamed CMake option USE_DISCORD_PRESENCE to ENABLE_DISCORD_RPC
- **changed** — Enabled ENABLE_QT_TRANSLATION CMake option by default, adding qt6-tools-dev as a new default build dependency
- **fixed** — Fixed linker warning spam related to minimum macOS version when Discord RPC was enabled
- **fixed** — Fixed compilation failure when a system MoltenVK install was present
- **fixed** — Fixed compilation error when building in debug mode
- **fixed** — Fixed an issue which prevented the azahar-room Dockerfile from building with Podman
- **added** — Added debug scopes to OpenGL renderer rasterizer and texture runtime

<h3>⚠️Important Alpha Information⚠️</h3>

As an alpha release, this build is not yet considered stable.

This prerelease is intended for users to test upcoming features, allowing the community to provide feedback before they are distributed in a stable release.
Users interested in testing bleeding-edge software are encouraged to test out this build to help us catch any issues we may have missed during development.

If you are unwilling to tolerate potential issues, it may be better to wait for the next stable release.

---

This changelog is relative to the changelog for 2126.0 Alpha 1. You can read that changelog here:
https://github.com/azahar-emu/azahar/releases/tag/2126.0-alpha1

---

#### Azahar 2126.0-alpha2 Changelog

#### Desktop

- Fixed a long-standing issue where Azahar's detection of the system language could be incorrect, resulting in an unexpected language being used in the UI. | @exertustfm #1558
- Many default messages in the user interface provided by upstream Qt (OK, Cancel, etc) are now translated for most languages. | @OpenSauce04 #2153 
  - For the following languages, these UI strings currently remain untranslated as before due to no translation being available for use in upstream Qt:
    - Greek, Indonesian, Norwegian Bokmål, Lithuanian, Romania, Vietnamese

#### Android

- On devices where ANGLE is used for OpenGL rendering, the Vulkan renderer is forcefully enabled due to extremely apparent visual defects when using the OpenGL renderer with ANGLE. | @OpenSauce04 #2197
  - You can tell if your device is affected by checking the renderer selection option in Azahar's settings. It will be greyed out and will display a message related to ANGLE when selected if you are using an ANGLE-enabled device.
  - Most devices will not yet be affected, however on and after Android 17's release, ANGLE will become enabled by default and mandatory for all _newly released devices_ (not necessarily devices updating to Android 17 from an earlier version).
- Assorted improvements and new options relating to secondary screen functionality. | @DavidRGriswold #1385

#### All

- Fixed an issue where certain older homebrew software would get stuck on a black screen at boot. | @Masamune3210 #2143
- Migrated many of our non-English language translations to simplified language codes, allowing correct system languages to be detected more consistently. | @OpenSauce04 #2152 
- Fixed an issue related to disabled cubemap texture units; known fixes in Brain Age: Concentration Training. | @Wunkolo #2159 
- Adjusted the unimplemented gas stub behaviour for the Vulkan renderer, fixing a known graphical issue in the Monster Hunter games. | @RedBlackAka #2165
- Fixed a typo in a settings log message. | @72374 #2076
- Additional refinements relating to the new GDB implementation. | @PabloMK7 #2145
- Fixed a possible integer overflow issue relating to custom Luma3DS mapping + optimized implementation. | @0x48kirenh #2202

#### Docker

- Distribute an ARM64 Docker image binary. | @OpenSauce04 #2151

#### macOS

- Fixed several minor issues relating to MoltenVK/Metal. | @sergeymild #2149

#### Technical

- The `USE_DISCORD_PRESENCE` CMake option has been renamed to `ENABLE_DISCORD_RPC`. Downstream users/maintainers should compensate for this accordingly. | @OpenSauce04 #2216
- The `ENABLE_QT_TRANSLATION` CMake option is now enabled by default, adding `qt6-tools-dev` or your package manager's equivalent as a new default build dependency for the Qt frontend if you weren't already manually enabling this flag. | @OpenSauce04 #2206 
- Fixed linker warning spam related to the minimum macOS version when Discord RPC was enabled. | @OpenSauce04 #2216
  - This issue has existed for a very long time, and doesn't seem to have ever caused any actual issues. This is likely just a technical correctness thing.
- Fixed a compilation failure which could manifest when a system MoltenVK install was present, even

_[Truncated at 4000 characters — full notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0-alpha2]_

### 2126.0-alpha1 — Azahar 2126.0 Alpha 1

- Date: 2026-05-16
- Version: 2126.0-alpha1
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0-alpha1
- Permalink: https://whatsnew.fyi/product/azahar/releases/2126.0-alpha1
- Labels: Pre-release; Platforms: Desktop, Android

- **added** — Introduce new MXE build variant for Windows as replacement for the MSYS2 variant
- **added** — Implement CLI for compression functionality via new -c and -x options
- **added** — Add option to toggle whether the emulated 3DS system thinks headphones are plugged in
- **added** — Implement GPU interrupt queue and GPU timing emulation to improve emulation accuracy
- **changed** — Completely revamp the implementation of GDB functionality with numerous debugging improvements and new features
- **changed** — Adjust how emulator error messages are displayed to be more easily understandable and user-friendly
- **changed** — Emit LG2/EX2 subroutine functions for shaders only when necessary instead of for every shader to reduce memory usage
- **changed** — Update NDK and AGP to more recent versions
- **fixed** — Fix an issue in Super Mario 3D Land which would prevent users from loading a save file after completing the game
- **fixed** — Fix GPU timing issues in Luigi's Mansion 2/Dark Moon
- **fixed** — Fix an issue where SDMC filenames containing unicode characters could appear and behave partially corrupted within emulated 3DS applications on macOS
- **fixed** — Fix building with OpenAL enabled on OpenBSD
- **fixed** — Fix an inability to generate translation source files in modern build environments due to an outdated qt_add_lupdate call
- **deprecated** — Deprecate MSYS2 build variant, to be removed in 2127.0 update

<h3>⚠️Important Alpha Information⚠️</h3>

As an alpha release, this build is not yet considered stable.

This prerelease is intended for users to test upcoming features, allowing the community to provide feedback before they are distributed in a stable release.
Users interested in testing bleeding-edge software are encouraged to test out this build to help us catch any issues we may have missed during development.

If you are unwilling to tolerate potential issues, it may be better to wait for the next stable release.

---

#### Azahar 2126.0-alpha1 Changelog

#### Windows

- Introduced the new "MXE" build variant previously discussed in [an announcement on our Discord server](https://discord.com/channels/1222589950365794477/1222591002145984675/1501920882069602315). | @OpenSauce04 #2044 
  - This new variant will serve as the replacement for the now-deprecated MSYS2 variant, which, as also previously discussed in the above post, will be removed in the 2127.0 update.
  - Users will be able to migrate from MSYS2 to MXE seamlessly, so existing MSYS2 users have no cause for concern.
  - For more information about this build, please read the aforementioned announcement post.

#### Desktop

- Implemented a CLI (command line interface) for Azahar's compression functionality via the new `-c` and `-x` options. | @OpenSauce04 #2084
  - See `azahar --help` for more info.

#### All

- 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.
- Implemented GPU interrupt queue & GPU timing emulation. | @PabloMK7 #2095 
  - 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 with this change, 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 big change behind the scenes, and may inadvertently introduce issues due to its large scope. If an issue appears in a game where it didn't exist before, the new behaviour can be toggled off by disabling the newly added "Simulate 3DS GPU timings" setting to see if this is the cause. Please report any issues which may have been introduced by the new behaviour accordingly.
  - The PR description contains an in-depth technical explanation of the changes.
- 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.
- Adjusted how emulator error messages are 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

#### macOS

- Fixed an issue where SDMC filenames which contain unicode characters could appear and behave partially corrupted within emulated 3DS applications. | @RigleGit #2079

#### Technical

- Fixed building with OpenAL enabled on OpenBSD. | @OpenSauce04 #2058 
- Fixed an inability to generate translation source files in modern build environments due to an outdated `qt_add_lupdate` call. | @OpenSauce04 #2071 
- Updated NDK and AGP to more recent versions. | @OpenSauce04 #2068

### 2125.1.2 — Azahar 2125.1.2

- Date: 2026-05-14
- Version: 2125.1.2
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2125.1.2
- Permalink: https://whatsnew.fyi/product/azahar/releases/2125.1.2
- Labels: Platforms: Desktop, Android

- **security** — Enabled Attestation and Software Bill Of Materials for release assets to increase release security
- **added** — Release assets are now immutable, preventing modification after publication
- **added** — Azahar release binaries are now attested with signed claims specifying production CI jobs, exact commit, timestamp, and other metadata
- **added** — Provide a verify-release bash script to help users verify the validity of Azahar releases and obtain the software bill of materials
- **changed** — Added EXCLUDE_FROM_ALL to CMake targets where applicable, speeding up build times for certain non-standard build configurations
- **changed** — All libretro core binaries are now stripped, greatly reducing filesize without affecting functionality

This is an unscheduled release to put into action new security policies we have enabled for Azahar after the recent [TeamPCP supply chain attacks](https://teampcp.cyberdigest.international/), which [affected big open source projects like CEMU Emulator](https://github.com/cemu-project/Cemu/issues/1911).

**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](https://archive.org/details/@azahar_emulator). 
      - 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](https://github.com/azahar-emu/azahar/attestations).
   -  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.

### 2125.1.1 — Azahar 2125.1.1

- Date: 2026-04-21
- Version: 2125.1.1
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2125.1.1
- Permalink: https://whatsnew.fyi/product/azahar/releases/2125.1.1
- Labels: Platforms: Desktop, Android

- **fixed** — Fixed a regression where Azahar could appear to have rounded window corners while fullscreened on Windows
- **fixed** — Fixed a regression where a small number of games could crash due to a shadow texture handling oversight
- **changed** — Changed use of std::powf function to std::pow to restore wider build environment compatibility
- **fixed** — Fixed OpenBSD build compatibility issues

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

### 2125.1 — Azahar 2125.1

- Date: 2026-04-14
- Version: 2125.1
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2125.1
- Permalink: https://whatsnew.fyi/product/azahar/releases/2125.1
- Labels: Platforms: Desktop, Android

- **added** — Emulate the 3DS's notification LED
- **added** — Add a UI element to the desktop frontend which displays the emulated 3DS's notification LED
- **added** — Add a button to the Android about game dialog which allows deletion of disk shader cache on a per-game basis
- **added** — Add new ENABLE_BUILTIN_KEYBLOB CMake option, enabled by default
- **added** — Add new USE_SYSTEM_OAKNUT CMake option
- **changed** — Implement syscore CPU time limiting to match real hardware behaviour
- **changed** — Enable the BOSS LLE module by the 'Enable required LLE modules for online features' setting
- **changed** — Optimize GeometryEmitter SETEMIT state for minor performance improvement in games using geometry shaders
- **changed** — All Android builds of Azahar, including the libretro core, now use the Vulkan renderer by default
- **changed** — Improve logging for SVC failures
- **changed** — Cross-compile x86_64/Intel macOS binaries from an ARM64 macOS runner
- **fixed** — Fix color blend modes behaving incorrectly on the OpenGL graphics backend
- **fixed** — Fix emulated applications receiving incorrect error values from getaddrinfo/getnameinfo functions
- **fixed** — Fix Discord rich presence not being set correctly due to a race condition on the desktop frontend
- **fixed** — Fix orientation changes while a 3DS application is booting causing the Android emulator to crash
- **fixed** — Fix hidden 3DS system titles appearing in the Android application list
- **fixed** — Fix Android issue where launching a game via intent while another game was open would cause the new game to load infinitely
- **fixed** — Fix Android app crash when resetting the background color setting to default
- **fixed** — Fix application exits resulting in an 'Invalid ROM Format' error dialog
- **fixed** — Fix libretro core crashing under certain circumstances when using the Vulkan renderer
- **fixed** — Fix linker error when building Azahar's test suite alongside the libretro core with GCC
- **removed** — Remove Vulkan warnings which could appear at application launch on setups with missing Vulkan features
- **removed** — Remove Mesa OpenGL version override due to improved upstream support

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 correctnes

_[Truncated at 4000 characters — full notes: https://github.com/azahar-emu/azahar/releases/tag/2125.1]_