Azahar 2126.0 Release Candidate 2

[OpenSauce04]

⚠️Important Release Candidate Information⚠️

This is a release candidate. Please expand this drop-down to read more about what this means before installing.

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.

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.

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.

Users are advised to back up their Azahar user data directory before using a pre-release build.

---

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 gsp: Fix GPU interrupt queue and add GPU timing emulation #2095, core: Refactor thread unschedule and add debug frontend unschedule #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 Revamp GDB implemenation and add a some minor debug features #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 renderer_vulkan: Fix screenshot color channels on RGBA swapchain formats #2170
• Added a setting to skip presenting duplicate frames, which is enabled by default. | @KojoZero Add Skip Presenting Duplicate Frames Feature #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 audio: Add option to simulate headphones plugged in #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 ui: Made rom loading errors more clear and user friendly #2097
• LG2/EX2 subroutine functions are now only emitted for shaders when necessary, instead of for every shader, reducing memory usage. | @Wunkolo shader_jit: Emit LG2/EX2 subroutines on-demand #2046
• Fixed an issue where certain older homebrew software would get stuck on a black screen at boot. | @Masamune3210 initialize IRQ_CMP #2143
• Migrated many of our non-English language translations to simplified language codes, allowing correct system languages to be detected more consistently. | @OpenSauce04 Migrate translations to new language codes #2152
• Fixed an issue related to disabled cubemap texture units; known fixes in Brain Age: Concentration Training. | @Wunkolo renderer_gl: Fix disabled cubemap texture units #2159
• Adjusted the unimplemented gas stub behaviour for the Vulkan renderer, fixing a known graphical issue in the Monster Hunter games. | @RedBlackAka video_core: Change unimplemented gas stub behavior for Vulkan #2165
• Fixed a typo in a settings log message. | @72374 Fix typo in Renderer_DelayGameRenderThreadUs #2076
• Fixed a possible integer overflow issue relating to custom Luma3DS mapping + optimized implementation. | @0x48kirenh core/memory: Fix undefined behavior and optimize Luma alias path #2202
• Implemented APT:MapProgramIdForDebug. | @PabloMK7 core: Implement APT:MapProgramIdForDebug #2224
• Fixed handling of APT communication between applications. | @DaniElectra apt: Properly implement app ID checks #2225
  • This fixes an issue in the Miiverse posting applet.
• Fixed behaviour of HTTPC:GetRequestState when the request still has pending post data. | @PabloMK7 Fix HTTPC post behaviour and add URL replacement feature #2234
  • This fixes the miiverse applet not being able to upload posts due to incorrect behaviour.
• Added an API to allow applications to register and unregister URL replacements. Pretendo Network Nimbus now uses this to submit rules for URL replacement. | @PabloMK7 Fix HTTPC post behaviour and add URL replacement feature #2234
• Fixed a crash on color fill when using the Vulkan Renderer. | @capito27 video_core: vulkan: Fix crash on color fill before framebuffer setup #2241
• Disabled PICA debug functionality on all platforms, with it now being a configurable option. | @PabloMK7 core: Make PICA debugging a toggleable feature #2254
• Fixed an issue related to fill surface downloading, which could cause graphical bugs in come edge cases. | @PabloMK7 video_core: Fix fill surface downloading #2270
• Implemented APT::GetAppletProgramInfo. | @PabloMK7 core: apt: Add unimplemented function and fix buffer capture handling #2272
  • Known to be used by Miiverse, but is also likely used elsewhere.
• Improved the accuracy of emulated CPU timings, fixing potential timing-related bugs. | @ApfelTeeSaft core/arm: model ARM11 MPCore timing per TRM #2262
  • Known to fix a softlock issue in Lego City Undercover: The Chase Begins, possibly fixes other issues elsewhere.
• Fixed an issue which would corrupt the suspended application framembuffer in some cases.
  • This prevented users from posting images to Miiverse, which is now fixed. | @PabloMK7 core: apt: Add unimplemented function and fix buffer capture handling #2272
• Improvements to the accuracy of the GSP service, fixing issues relating to suspending applications, posting to Miiverse, and Donkey Kong Country Returns. | @PabloMK7 core: gsp: General improvements to GSP service accuracy #2273
  • Likely addresses other unknown issues elsewhere.
• Replaced various URLs which previously linked to archived Citra website pages to instead point to the Azahar wiki. | @RedBlackAka UI: Replace all archive links with Azahar wiki pages #1881

Android

• Added multiplayer room functionality. | Kleidis, @rtiangha, @Gamer64ytb, @weihuoya, @PabloMK7 android: Add various network/room related capabilities (private/public room creation/joining and public lobby browsing) #830
  • This change includes most of the multiplayer functionality found in the desktop version of Azahar.
    • Public room browsing, private room creation, private room joining and chat are implemented.
    • Public room creation and some minor UI features, such as room descriptions or currently playing applications, are not yet implemented.
  • This feature does NOT implement communication with real consoles nor direct connect between Android devices in near proximity.
    • Android devices need to be connected to the same Wifi network to be able to play together (or use the Android built-in hotspot or wifi sharing functionality).
  • Public room browsing is possible as long as the user provides an unofficial web API URL in the new network settings. Official public rooms are still not provided by Azahar.
• 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 android: Force use of Vulkan if OpenGL renderer is ANGLE #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).
• Added a new "Combo Button" to the on-screen controller overlay which presses multiple buttons at the same time when pressed. @ADAS2024 [Android] Add Combo Button #1244 Improve combo icon #2266
  • The buttons activated when the Combo Button is selected can be configured from the settings.
  • This button is hidden by default, and must be toggled on in the overlay options.
• Assorted improvements and new options relating to secondary screen functionality. | @DavidRGriswold Android: Secondary Layout and Menu Improvements #1385
• Fixed several issues related to the "Adjust Scale" menu. | @OpenSauce04 android: Assorted "Adjust Scale" fixes #2256

Android (vanilla)

• Added an in-app toggleable update checker which runs when Azahar starts, functioning the same way as the desktop version. | @OpenSauce04 android: Implement update checker functionality mirroring the Qt frontend #2265

Desktop

• Implemented a CLI (command line interface) for Azahar's compression functionality via the new -c and -x options. | @OpenSauce04 Implement Z3DS compression CLI in new citra_cli static library #2084
  • See azahar --help for more info.
• Various improvements to controller integration with Azahar's desktop frontend, including controller hotkeys. | @DavidRGriswold Desktop: Controller improvements - readable labels, controller hotkeys, option to apply profiles to all controllers #1717
• Fixed some hotkeys not working correctly when using the Separate Windows screen layout. | @DavidRGriswold Bugfix: All desktop hotkeys now work in dual-window mode #1967
• After uninstalling an app, update or DLC, the game list is now refreshed. | @andrey545454 Refresh game list after uninstalling installed titles #2237
• Adjusted "Open Azahar Folder" menubar option to now include variants "NAND Folder" and "SDMC Folder". | @PabloMK7 qt: Add open NAND and SDMC folder options #2279

Windows

• Introduced the new "MXE" build variant previously discussed in an announcement on our Discord server. | @OpenSauce04 Changes and fixes to support compilation in an MXE build environment #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.
• 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 qt: Fix incorrect system language detection #1558
• Many default messages in the user interface provided by upstream Qt (OK, Cancel, etc) are now translated for most languages. | @OpenSauce04 qt: Use upstream Qt Base translations where available #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

macOS

• Fixed an issue where SDMC filenames which contain unicode characters could appear and behave partially corrupted within emulated applications. | @RigleGit macOS SDMC filename Unicode mismatch on accented characters #2079
• Fixed several minor issues relating to MoltenVK/Metal. | @sergeymild macos: fix Vulkan/Metal renderer on macOS 26+ and bump MoltenVK #2149

Docker

• Distribute an ARM64 Docker image binary. | @OpenSauce04 Assorted azahar-room Docker image improvements (incl. ARM64 support) #2151

Technical

• The USE_DISCORD_PRESENCE CMake option has been renamed to ENABLE_DISCORD_RPC. Downstream users/maintainers should compensate for this accordingly. | @OpenSauce04 Technical Discord rich presence adjustments #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 cmake: Enable ENABLE_QT_TRANSLATION by default #2206
• Fixed linker warning spam related to the minimum macOS version when Discord RPC was enabled. | @OpenSauce04 Technical Discord rich presence adjustments #2216
  • This issue has existed for a very long time, and doesn't seem to have ever caused any actual issues. This is just a technical correctness thing.
• Fixed a compilation failure which could manifest when a system MoltenVK install was present, even if it wasn't being used. | @crueter [cmake] Fix MoltenVK fetch order/library conflicts #2183
• Fixed a compilation error when building in debug mode. | @Wunkolo core: Fix debug compile error #2132
• Fixed an issue which prevented the azahar-room Dockerfile from building with Podman. | @OpenSauce04 Assorted azahar-room Docker image improvements (incl. ARM64 support) #2151
• Added debug scopes to OpenGL renderer rasterizer and texture runtime. | @Wunkolo renderer_gl: Add DebugScopes to rasterizer and texture-runtime #2133
• Extensive Kotlin codebase formatting cleanup + new formatting/style enforcement in CI via ktlint. | @OpenSauce04 android: Integrate ktlint formatting/style checker for kotlin #2204
• Fixed building with OpenAL enabled on OpenBSD. | @OpenSauce04 Fix building w/ OpenAL on OpenBSD #2058
• Fixed an inability to generate translation source files in modern build environments due to an outdated qt_add_lupdate call. | @OpenSauce04 qt: Fixed outdated use of qt_add_lupdate #2071
• Updated NDK and AGP to more recent versions. | @OpenSauce04 android: Bump NDK and AGP versions #2068
• Fixed a compilation issue when building with MSYS2 due to upstream package changes. | @PabloMK7 dynarmic: Update to latest commit #2236
• Fixed a potential build failure due to a missing include. | @asyync1024 audio_core: Add '#include <cstring>' to cubeb_sink and cubeb_input.cpp #2232
• Fixed a build failure when attempting to build the libretro core with MSVC due to a malformed switch case. | @XenuIsWatching libretro: scope Vulkan case to fix MSVC build (C2360) #2267

---

This discussion was created from the release Azahar 2126.0 Release Candidate 2.

[mattiaslundahl]

I updated to this version and still have issues with Super Mario 3D Land.

The level loads correctly now, so that particular problem seems to have solved itself.

I looked in the control settings in the emulator itself in desktop mode, but I don't see any mapping there that would make the "Start" button on the Steam Deck reset the game to the title screen. I just see that it is indeed mapped to the 3DS Start button.

Mario is also constantly crouching when entering the level, as if R or ZR is pressed, but I am not pressing either of those buttons.

The controller profile is SD Default, and I tried clearing all hotkeys, but the issues still remain.

[528288667-cmd]

The emulator crashes immediately when trying to join a multiplayer room on Android (2126.0-rc2)