Lime3DS
Lime3DS est un fork de Citra dédié à l’émulation de la Nintendo 3DS, développé par Reg Tiangha et proposé ici en version 2119.1, avant son remplacement annoncé par Azahar.
Lime3DS est un émulateur dédié à la Nintendo 3DS, dérivé de Citra et développé par Reg Tiangha. Il vise à reproduire fidèlement les jeux et fonctionnalités de la console portable, incluant les titres physiques et virtuels, ainsi que certaines particularités matérielles comme le 3D stéréoscopique.
Bien que compatible avec macOS, son utilisation sur les modèles récents (notamment ceux équipés d’Apple Silicon) n’est pas officiellement confirmée. Son développement semble désormais suspendu, comme en témoigne la redirection vers Azahar, un autre émulateur issu de la même lignée. Les utilisateurs cherchant une alternative pour la 3DS devront se tourner vers cette dernière ou d’autres solutions.
Dernière mise à jour :
Plateformes
Architecture
Mac OS X - macOS
Apple Silicon
64 bits
Téléchargement et liens
- Télécharger Lime3DS
- Site officiel
- Code source 8 723 étoiles sur GitHub
- Licence : GPL-2.0
Historique des versions
2126.1.2
- Correction d’un blocage ou plantage total de RetroArch lors de la sortie d’un jeu dans les cœurs libretro d’Azahar.
- Mise à jour identique pour les autres versions d’Azahar que la version 2126.1.1.
C'est une sortie de correction non prévue qui corrige un problème fréquemment rencontré dans les noyaux libretro d'Azahar.
Pour les autres versions d'Azahar, cette mise à jour est identique à la version 2126.1.1.
Journal des modifications Azahar 2126.1.2
libretro
- Corrigé un problème pouvant provoquer un gel complet ou un plantage de RetroArch lors de la sortie d'un jeu. | @Razor221 #2572
2126.1.1
- Correction d’un crash systématique à l’ouverture sur systèmes avec un support Vulkan défaillant.
- Désactivation par défaut de l’option "Skip Presenting Duplicate Frames" en raison de régressions mineures.
- Correction d’un crash du rendu Vulkan lors du traitement de textures d’ombres spécifiques (ex. : Monster Hunter 4 Ultimate après ouverture du menu équipement).
- Affichage du variant de build utilisé (MXE, MSVC ou MSYS2) dans le menu À propos et le fichier de log.
Ceci est une sortie de correction non prévue qui corrige quelques problèmes notables découverts après le lancement de la mise à jour 2126.1.
Tous les utilisateurs sont encouragés à mettre à jour dès que possible.
Journal des modifications Azahar 2126.1.1
Pour tous
- Corrigé un problème où Azahar pouvait s'arrêter instantanément à l'ouverture sur certains systèmes avec un faible support Vulkan.
- L'option « Skip Presenting Duplicate Frames » est désormais désactivée par défaut en raison de régressions mineures par rapport au comportement précédent.
- Corrigé un problème pouvant provoquer un plantage du rendu Vulkan d'Azahar lors du traitement de certaines textures d'ombres.
- Corrigé un plantage dans Monster Hunter 4 Ultimate après l'ouverture du menu équipement.
Pour Windows
- Le menu À propos et le fichier de journal d'Azahar indiquent désormais la variante de construction utilisée (MXE, MSVC ou MSYS2).
2126.1
- Stabilité renforcée : suppression de nombreux risques de plantages, notamment lors du chargement d'états de jeu ou en multiplayer.
- Résolution interne maximale augmentée : passage de 10x (4000x2400) à 18x (7200x4320) pour supporter les écrans 8K.
- Corrections graphiques majeures : gestion des shaders géométriques (SEGA 3D Classics), précision des flottants et textures cubemaps dans Vulkan.
- Audio amélioré : suppression des craquements lors de changements de volume (menu Home) et optimisation HLE pour les buffers PCM16.
- macOS : prise en charge de Liquid Glass sur macOS 26 et correction des connexions réseau locales (ex. 3DS physique) sous macOS 27.
- Sauvegardes : blocage des états de jeu à la version émulateur d'origine, avec message d'erreur clair au lieu de crash.
Cette version mineure contient de nombreuses améliorations et corrections qui n'ont pas été intégrées dans la version de base 2126.0. Une attention particulière a été portée dans cette version aux améliorations de stabilité, éliminant les risques de plantages dans de nombreux scénarios identifiés. Tous les utilisateurs sont encouragés à mettre à jour dès que possible.
Journal des modifications Azahar 2126.1
Tous
-
Les états de sauvegarde sont désormais verrouillés sur la version d'Azahar avec laquelle ils ont été créés.
- Tentative de charger un état de sauvegarde depuis une version différente d'Azahar affichera désormais un message d'erreur expliquant cette restriction, et indiquera également la version d'Azahar avec laquelle l'état de sauvegarde a été initialement créé, recommandant un retour temporaire à une version antérieure pour récupérer les progrès en utilisant la fonctionnalité de sauvegarde intégrée si nécessaire.
- Cela ne limite pas l'utilisation des états de sauvegarde par rapport au comportement précédent. Avant ce changement, charger un état de sauvegarde depuis une version antérieure d'Azahar provoquait simplement un plantage de l'émulateur. Ce changement affiche désormais un message de manière gracieuse.
- Correction d'un problème où il était possible de supprimer des surfaces de texture en cours d'utilisation, notamment avec des paramètres de résolution interne plus élevés.
- Cette modification corrige les plantages liés à Vulkan dans de nombreux jeux et situations. Notamment lors du lancement de missions dans Monster Hunter 4 Ultimate.
- Le paramètre de mise à l'échelle de résolution interne maximale a été augmenté de 10x (4000x2400) à 18x (7200x4320), permettant aux écrans 8K de tirer pleinement parti de la fonctionnalité d'upscaling.
-
Correction d'un plantage dans Teenage Mutant Ninja Turtles: Danger of the Ooze lors de l'utilisation du rendu Vulkan, dû à un mauvais traitement du mode de désactivation du rasterizer défini à une valeur inhabituelle.
-
Correction d'un problème causant un lag excessif à l'écran de sélection de personnages dans Super Smash Bros 4.
-
Correction d'un problème causant un lag excessif dans Mini Mario & Friends: Amiibo Challenge lors de la marche sur des surfaces diagonales.
-
Correction d'une régression provoquant le plantage du menu des amis 3DS lors de son ouverture.
-
Correction d'un plantage pouvant parfois survenir lors de sessions multijoueur en raison de logiques non sécurisées pour les threads.
-
Mise en œuvre d'optimisations dans le traitement des listes de commandes GPU, économisant 0,5 à 1 ms de temps de traitement par image en moyenne.
@PabloMK7 #2338
- Les jeux mentionnés présentent toujours d'autres problèmes de rendu nécessitant des corrections dans les futures versions de l'émulateur.
- Correction de la précision des nombres flottants dénormalisés, ce qui résout divers problèmes de rendu dans plusieurs jeux.
@Wunkolo #2350
- Correction d'un problème où le filtrage linéaire était activé de force avec certains pilotes, principalement sur Android avec Adreno.
@PabloMK7 #2445
- Correction d'un problème où le navigateur Internet de la 3DS pouvait geler en raison d'un comportement incorrect de réorganisation du cœur.
@PabloMK7 #2370
- Mise en œuvre d'une amélioration du traitement audio émulé qui corrige les bruits de craquement lorsque le volume d'une source audio est modifié. @Grayforz2468 #2409
- L'exemple le plus notable est que le menu principal n'a plus de musique qui craque.
- Correction d'un problème qui provoquait des bruits de craquement dans l'émulation audio HLE pour les jeux qui mettent à jour des tampons PCM16 en boucle alors qu'ils sont en cours de lecture.
@Angelico2102 #2454
- Cela permet de résoudre les problèmes audio connus dans "Inazuma Eleven 3".
- Correction d'un problème dans le rendu Vulkan lié à la gestion des unités de textures cubemap désactivées.
@Wunkolo #2406
- Cela apporte une correction qui avait été précédemment appliquée au rendu OpenGL lors d'une mise à jour antérieure.
- Correction d'un accès mémoire invalide lié aux balises uds. Cela peut résoudre des problèmes non découverts dans certains jeux multijoueurs.
@PabloMK7 #2403
- Mise en place de vérifications pour s'assurer que les couches Vulkan que le système ne supporte pas ne sont pas activées, évitant ainsi des plantages sur certaines configurations.
@Wunkolo #2511
- Correction d'un plantage pouvant survenir pendant le jeu dans certaines circonstances lors de l'utilisation de textures personnalisées.
@demetriospantaleao-del #2481
Windows (MXE)
- Correction d'un plantage pouvant se produire lors de la tentative de lancement de toute application avec le rendu Vulkan en utilisant la construction MXE.
@OpenSauce04 #2392
- Correction d'un problème où le rythme des images pouvait être incohérent lors de l'utilisation de la construction MXE.
@OpenSauce04 #2392
Bureau
- La valeur minimale de sensibilité de contrôle de mouvement a été réduite de 0,01 à 0,001.
@ParadiseOfMagic #2383
Linux
- Les versions AppImage pour Wayland et non-Wayland ont à nouveau été fusionnées en un seul binaire incluant le support Wayland. Cela est dû à la résolution du problème de plantage initial ayant causé la séparation.
@Kyuyrii #1727
Android
- Mise à jour de la version ciblée de l’Android SDK de l’Android 15 (35) à l’Android 17 (37).
@OpenSauce04 #2416
- Correction de diverses crises liées à des cas limites de gestion des surfaces pouvant survenir au démarrage d’un jeu, lors de la rotation de l’écran, pendant la suspension d’une application ou lors du chargement d’un état de sauvegarde.
@PabloMK7 #2425
- Correction d’un problème où les builds de débogage d’Azahar sur Android s’écrasaient instantanément en raison d’une erreur logique liée à la validation de la configuration.
@PabloMK7 #2398
- Correction d’un problème où, si une application 3DS se fermait ou rencontrait une erreur fatale et que l’utilisateur sélectionnait « Abandonner », l’émulateur s’écrasait au lieu de revenir au menu des applications.
@PabloMK7 #2399
- Correction d’un problème qui faisait s’écraser Azahar si un état de sauvegarde était chargé après avoir été lancé depuis un frontend tiers.
@PabloMK7 #2452
- Correction d’un problème où Azahar s’écrasait s’il n’avait pas encore effectué la configuration initiale et qu’un lanceur tiers tentait de le démarrer.
@PabloMK7 #2452
- Les ROMs invalides sont désormais affichées avec une carte « ROM invalide » dans la liste des jeux au lieu d’apparaître en blanc.
@OpenSauce04 #2509
- Correction de divers problèmes et inexactitudes liés à l’étiquetage des balises de traduction de chaînes.
@OpenSauce04
- Les chaînes de l’interface utilisateur indiquant la région d’origine d’un jeu (par exemple, « Europe, Australie ») sont désormais traduisibles dans l’interface frontend pour les langues non anglaises.
@OpenSauce04 #2497
- Comme pour toutes les traductions, cela repose sur la fourniture de traductions pour chaque langue par la communauté et peut ne pas être traduit immédiatement.
- Si vous maîtrisez une langue non anglaise que nous supportons et souhaitez contribuer, vous pouvez rejoindre notre page Transifex et contribuer aux traductions ici : https://app.transifex.com/azahar/azahar/dashboard/
macOS
- Activation des éléments d’interface Liquid Glass sur macOS 26.
@OpenSauce04 #2429
- Correction d’un problème lors de l’utilisation de macOS 27 où la connexion à des appareils locaux comme un vrai 3DS échouait toujours (par exemple, Artic Base, configuration des fichiers système).
@OpenSauce04 #2428
libretro
- Les paramètres « Mode 3D stéréoscopique » et « Profondeur 3D stéréoscopique » sont désormais disponibles pour le noyau libretro.
@XenuIsWatching #2339
- Version mise à jour de l’NDK utilisée pour compiler le cœur Android libretro en 29.x
Technique
- La compilation MXE est désormais effectuée dans un environnement de construction basé sur LLVM+Clang, remplaçant l’ancienne pile GCC.
@OpenSauce04 #2392
- Un immense merci à @kleisauke, qui pendant environ un an et demi a maintenu sans relâche un plugin MXE LLVM non officiel dans un dépôt GitHub comptant seulement une étoile. Sans leur travail, cette réalisation aurait pris bien plus de temps qu’elle n’en a pris.
- Ajout des années de copyright dans tous les en-têtes de licence du code source.
@PabloMK7 #2415
- Implémentation d’une solution de contournement pour un bug actuel du compilateur MSVC.
@PabloMK7 #2410
- Ajout d’une nouvelle option CMake
CITRA_ADDRESS_SANITIZE.
@PabloMK7 #2402
FreeBSD
- Lors de la compilation sur FreeBSD, le système libusb est désormais toujours utilisé en raison de son inclusion dans le système d’exploitation.
@sonphantrung #2281
2126.1-rc5
- Correction d'une régression majeure provoquant une fuite mémoire persistante lors de l'exécution d'applications avec le rendu OpenGL.
- Version candidate de sortie, non stable, susceptible d'être promue après tests approfondis.
- Rappel à sauvegarder le dossier Azahar user data avant utilisation.
- Aucune nouvelle fonctionnalité ou modification majeure par rapport à la version rc4.
⚠️ Informations importantes concernant la version candidate ⚠️
Cette version est une candidate de sortie. Veuillez développer cette section pour en savoir plus sur ce que cela signifie avant d'installer.
En tant que version candidate, cette construction n'est pas encore considérée comme une version stable, mais elle représente une version qui pourrait être promue en version stable si elle est suffisamment testée sans que des problèmes majeurs ne soient découverts. Idéalement, la période de version candidate durera sept jours, mais si des problèmes majeurs sont découverts, elle sera prolongée pour permettre des tests supplémentaires avec une version candidate corrigée.
Malgré son statut de version pré-livrée, les utilisateurs sont encouragés à tester cette version afin de nous aider à détecter tout problème nouvellement introduit avant que la version ne soit promue en version complète. Si vous observez de tels problèmes, veuillez les signaler sur GitHub afin que nous puissions les évaluer.
Si vous n'êtes pas prêt à tolérer des problèmes mineurs potentiels, il pourrait être préférable d'attendre qu'une version candidate soit promue en version complète.
Les utilisateurs sont invités à sauvegarder leur répertoire de données utilisateur Azahar avant d'utiliser une version pré-livrée.
Cette version candidate corrige une seule régression critique apparue pour la première fois dans la version pré-livrée 2126.1-rc3. Elle est sinon identique à la version 2126.1-rc4.
Pour obtenir une vision plus complète de ce qui sera inclus dans la version finale, vous pouvez consulter le journal des modifications pour la version candidate 1 ici : https://github.com/azahar-emu/azahar/releases/tag/2126.1-rc1
Journal des modifications Azahar 2126.1-rc5
Tous
- Correction d'une régression provoquant une fuite mémoire constante lors de l'exécution d'une application avec le rendu OpenGL. | @Wunkolo #2517
- Ce problème affectait toutes les plateformes prenant en charge le rendu OpenGL, mais le taux de fuite mémoire était beaucoup plus marqué sous Windows.
2126.1-rc4
- Ajout de vérifications pour bloquer l’activation de couches Vulkan non supportées par le système, évitant des plantages.
- Désactivation par défaut du gestionnaire d’exceptions de débogage, corrigé pour éviter des crashes de mods ciblant l’émulateur.
- Affichage d’une carte « Invalid ROM » dans la liste des jeux pour les ROMs invalides, remplaçant les cartes vides erronées.
⚠️Important Informations sur la Release Candidate⚠️
Cette version est une release candidate. Veuillez développer cette section pour en savoir plus sur ce que cela signifie avant d'installer.
En tant que release candidate, cette version n'est pas encore considérée comme une sortie stable, mais plutôt comme une version susceptible d'être promue en sortie stable si elle est suffisamment testée sans que des problèmes majeurs ne soient découverts. Idéalement, la période de release candidate durera 7 jours, mais si des problèmes majeurs sont découverts, elle sera prolongée pour permettre un test supplémentaire avec une nouvelle release candidate corrigée.
Malgré son statut de version pré-livraison, les utilisateurs sont encouragés à tester cette version pour nous aider à détecter tout problème nouvellement introduit avant que la version ne soit promue en sortie complète. Si vous observez de tels problèmes, veuillez les signaler sur GitHub afin que nous puissions les évaluer.
Si vous n'êtes pas prêt à tolérer des problèmes mineurs potentiels, il pourrait être préférable d'attendre qu'une release candidate soit promue en sortie complète.
Les utilisateurs sont invités à sauvegarder leur répertoire de données utilisateur Azahar avant d'utiliser une version pré-livraison.
Cette release candidate est une mise à jour de la version 2126.1-rc3. Elle introduit quelques ajustements et corrections finaux en préparation de la sortie stable. Nous espérons que ce sera la dernière release candidate, à condition qu'aucun problème majeur ne soit découvert.
Pour avoir une vision plus complète de ce qui sera inclus dans la sortie finale, vous pouvez consulter le changelog de la Release Candidate 1 ici : https://github.com/azahar-emu/azahar/releases/tag/2126.1-rc1
Changelog Azahar 2126.1-rc4
Tous
- Implémentation de vérifications pour s'assurer que les couches Vulkan que le système ne supporte pas ne sont pas activées, évitant ainsi des plantages sur certaines configurations. | @Wunkolo #2511
Bureau
- Correction du paramètre pour le nouveau gestionnaire d'exceptions de débogage qui était activé par défaut de manière erronée ; il est désormais désactivé par défaut. | @PabloMK7 #2505
- Avoir ce paramètre activé peut provoquer des plantages sur certains mods de jeux qui ciblent spécifiquement les émulateurs.
Android
- Les ROMs invalides sont désormais affichées avec une carte "ROM Invalide" dans la liste des jeux au lieu d'être vides. | @OpenSauce04 #2509
- Ces cartes vides contenaient accidentellement une chaîne d'erreur dans 2126.1-rc3 en raison d'une omission. Par la nature de ce changement, ce problème a également été corrigé.
2126.1-rc3
- Correction d’un plantage lors du changement de résolution interne pendant l’émulation, provoquant des artefacts graphiques et des fuites mémoire.
- Résolution d’un crash potentiel pendant le jeu avec des textures personnalisées sous certaines conditions.
- Correction d’une régression dans 2126.1-rc1 causant des saccades audio majeures avec le stretching audio activé.
⚠️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.
This release candidate is an amendment to 2126.1-rc2. It primarily addresses issues discovered in the prior 2126.1 prereleases.
For a more complete picture of what will be included in the final release, you can see the changelog for Release Candidate 1 here: https://github.com/azahar-emu/azahar/releases/tag/2126.1-rc1
Azahar 2126.1-rc3 Changelog
All
- Fixed a crash first seen in 2126.1 Alpha 1 where changing the internal resolution during emulation could cause graphical artifacts and major memory leakage, resulting in a crash. | @Wunkolo #2489
- Fixed a crash which could happen during gameplay under certain circumstances while using custom textures. | @demetriospantaleao-del #2481
- Fixed a regression introduced in 2126.1 Release Candidate 1 which could cause major audio stuttering while audio stretching was enabled. | @OpenSauce04 #2487
- This issue was caused by a previously implemented attempt to improve audio latency while audio stretching was enabled (#2439). This has now been reverted.
Android
- UI strings which indicate which region a game is for/from (e.g. "Europe, Australia") are now translatable in the frontend for non-English languages. | @OpenSauce04 #2497
- As with all translations, this relies on translations being provided for each language by the community, and may not be translated immediately.
- If you are proficient in a non-English language we support and would like to contribute, you can join our Transifex page and contribute translations here: https://app.transifex.com/azahar/azahar/dashboard/
2126.1-rc2
- Correction d’un décalage de l’overlay de contrôleur à l’écran pour les appareils avec caméra avant après une installation neuve ou un réinitialisation.
- Suppression d’un offset horizontal/vertical sur les touches virtuelles quand l’option "Expand to Cutout Area" est activée pour les mêmes appareils.
- Ajustement léger de la disposition des boutons faciaux dans le modèle portrait par défaut pour une meilleure ergonomie.
⚠️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.
This release candidate is an amendment to 2126.1-rc1. It addresses regressions discovered in the Android build.
For a more complete picture of what will be included in the final release, you can see the previous changelog here: https://github.com/azahar-emu/azahar/releases/tag/2126.1-rc1
Azahar 2126.1-rc2 Changelog
Android
- Fixed a regression where using a fresh install of Azahar or resetting the on-screen controller overlay would result in the overlay layout being positioned partially off the edge of the screen for devices with a selfie camera. | @OpenSauce04 #2465
- Users affected by the aforementioned issue should reset their on-screen controller overlay layout using the side menu after updating. The issue will then be fixed.
- Fixed a regression where, when the "Expand to Cutout Area" setting was enabled, any touchscreen inputs to the virtual 3DS screen would be either horizontally or vertically offset for devices with a selfie camera. | @OpenSauce04 #2469
- Slightly adjusted the positioning of the face buttons in the default portrait layout for the on-screen controller overlay for better ergonomics. | @OpenSauce04 #2468
2126.1-rc1
- Augmentation du facteur d'échelle de résolution interne maximale de 10x à 18x (jusqu’à 7200x4320).
- Implémentation du geometry shader output register banking, corrigeant des problèmes de rendu dans plusieurs jeux SEGA 3D Classics sans patchs spécifiques.
- Sauvegardes d’état désormais verrouillées sur la version d’émulateur de création, avec message d’erreur clair en cas de compatibilité incompatible.
- Correction des crashes liés à la gestion des textures en cours d’utilisation, notamment avec Vulkan (ex. : Monster Hunter 4 Ultimate).
- Suppression des retards audio inutiles en désactivant le time stretching quel que soit le taux d’émulation.
- Activation des éléments d’interface Liquid Glass sur macOS 26.
- Correction des échecs de connexion aux périphériques locaux (ex. : 3DS réel) sous macOS 27.
⚠️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.
Click here to see only the changes made since Azahar 2126.1-alpha1, for those who already read the previous changelog.
All
- Fixed an issue where linear filtering was forcefully enabled with certain drivers, primarily on Android w/ Adreno. | @PabloMK7 #2445
- Fixed a crash which could sometimes occur during multiplayer sessions due to thread-unsafe logic. | @PabloMK7 #2405
- Fixed an issue which caused HLE audio emulation to produce crackling in games that update looping PCM16 buffers while they are being played. | @Angelico2102 #2454
- This is known to address audio issues in "Inazuma Eleven 3".
- Fixed an issue where Game Boy/ Game Boy Color virtual console titles would have part of the Virtual Console menu graphic incorrectly drawn off to the right edge of the screen. | @Davey-Hughes #2459
- Improved the exception handler dialog to contain more useful debugging information. | @ExplosBlue #2419
- Fixed an issue where audio time stretching was always applied regardless emulation speed, resulting in unnecessary audio delay. | @PabloMK7 #2439
Android
- Fixed a regression in 2126.1-alpha1 where the "Expand to Cutout Area" setting didn't work correctly. | @OpenSauce04 #2447
- Fixed an issue which would cause Azahar to crash if a save state was loaded after being launched from a 3rd-party frontend. | @PabloMK7 #2452
- Fixed an issue where Azahar would crash if it had not yet performed initial setup and a 3rd-party launcher attempted to start it. | @PabloMK7 #2452
- Fixed various issues/ inaccuracies related to string translation tagging. | @OpenSauce04
Linux
- The Wayland and non-Wayland AppImage have now been once again merged into a single binary which includes Wayland support. This is due to the original crash issue which caused the split now being fixed. | @OpenSauce04 #2458
libretro
- Updated NDK version used to build the Android libretro core to 29.x
FreeBSD
- When building on FreeBSD, system libusb is now always used due to being bundled with the OS. | @sonphantrung #2281
Azahar 2126.1-rc1 Changelog
All
- Save states are now locked to the version of Azahar that they were created with. | @PabloMK7 #2394
- Attempting to load a save state from a different Azahar version will now display an error message explaining this restriction, and will also display the version of Azahar that the save state was originally created with, recommending temporarily downgrading to retrieve progress using the in-game save functionality if necessary.
- This does not limit save state usage compared to previous behaviour. Before this change, loading a save state from a previous version of Azahar would just crash the emulator. This change now gracefully shows a message instead.
- Fixed an issue where it was possible for texture surfaces to be deleted while in use, especially at larger internal resolution settings. | @Wunkolo #2407
- This change fixes Vulkan related crashes in many different games and situations. Most notably, when starting missions in Monster Hunter 4 Ultimate.
- The highest available internal resolution scaling setting has been increased from 10x (4000x2400) to 18x (7200x4320). | @72374 #1906
- Implemented a fix for a crash in Teenage Mutant Ninja Turtles: Danger of the Ooze when using the Vulkan renderer due to inaccurate handling of the rasterizer cull mode being set to an unusual value. | @PabloMK7 #2396
- Fixed an issue which caused excessive lag in the character select screen for Super Smash Bros 4. | @PabloMK7 #2412
- Fixed an issue which caused excessive lag in Mini Mario & Friends: Amiibo Challenge when walking on diagonal surfaces. | @PabloMK7 #2412
- Fixed a regression which caused the 3DS friends menu to crash when opened. | @PabloMK7 #2412
- Fixed a crash which could sometimes occur during multiplayer sessions due to thread-unsafe logic. | @PabloMK7 #2405
- Implemented optimizations to GPU command list processing which save 0.5-1ms of processing time per frame on average. | @PabloMK7 #2318
- Implement geometry shader output register banking, which fixes a lot of SEGA 3D Classics games without the need of per-game patches. | @PabloMK7 #2338
- The mentioned games still present other rendering issues that need to be fixed in future versions of the emulator.
- Fix floating point denormal accuracy, which fixes various rendering issues in several games. | @Wunkolo #2350
- Fixed an issue where linear filtering was forcefully enabled with certain drivers, primarily on Android w/ Adreno. | @PabloMK7 #2445
- Fixed an issue where the 3DS Internet Browser would freeze due to incorrect core rescheduling behaviour. | @PabloMK7 #2370
- Implemented an improvement to emulated audio handling which fixes crackling sounds which an audio source's volume is changed. @Grayforz2468 #2409
- Most notable example is the Home Menu no longer having crackling music.
- Fixed an issue which caused HLE audio emulation to produce crackling in games that update looping PCM16 buffers while they are being played. | @Angelico2102 #2454
- This is known to address audio issues in "Inazuma Eleven 3".
- Fixed an issue in the Vulkan renderer related to the handling of disabled cubemap texture units. | @Wunkolo #2406
- This brings over a fix which was previously applied to the OpenGL renderer in a previous update.
- Fixed an invalid memory access issue related to uds beacons. May fix undiscovered issues in certain multiplayer games. | @PabloMK7 #2403
- Fixed an issue where audio time stretching was always applied regardless emulation speed, resulting in unnecessary audio delay. | @PabloMK7 #2439
Windows (MXE)
- Fixed crash which could occur when trying to launch any app with the Vulkan renderer while using the MXE build. | @OpenSauce04 #2392
- Fixed an issue where frame pacing could be inconsistent when using the MXE build. | @OpenSauce04 #2392
Desktop
- The minimum motion control sensitivity value has been reduced from 0.01 to 0.001. | @ParadiseOfMagic #2383
Linux
- The Wayland and non-Wayland AppImage have now been once again merged into a single binary which includes Wayland support. This is due to the original crash issue which caused the split now being fixed. | @OpenSauce04 #2458
- Implemented a measure to help avoid having a missing application icon with certain desktop environment setups. | @Kyuyrii #1727
Android
- Upgraded target Android SDK from Android 15 (35) to Android 17 (37). | @OpenSauce04 #2416
- Fixed various edge-case crashes related to surface handling which could occur at game boot, during screen rotation, during app suspension, or during save state loading. | @PabloMK7 #2425
- Fixed an issue where debug builds of Azahar on Android would instantly crash due to a logic error relating to configuration validation. | @PabloMK7 #2398
- Fixed an issue where, if a 3DS application closed itself or encountered a fatal error and the user selected "Abort", the emulator would crash instead of returning to the application menu. | @PabloMK7 #2399
- Fixed an issue which would cause Azahar to crash if a save state was loaded after being launched from a 3rd-party frontend. | @PabloMK7 #2452
- Fixed an issue where Azahar would crash if it had not yet performed initial setup and a 3rd-party launcher attempted to start it. | @PabloMK7 #2452
- Fixed various issues/ inaccuracies related to string translation tagging. | @OpenSauce04
macOS
- Enabled Liquid Glass interface elements on macOS 26. | @OpenSauce04 #2429
- Fixed an issue when using macOS 27 where connecting to local network devices such as a real 3DS would always fail (e.g. Artic Base, system files setup). | @OpenSauce04 #2428
libretro
- "Stereoscopic 3D Mode" and "Stereoscopic 3D Depth" settings are now available for the libretro core. | @XenuIsWatching #2339
- Updated NDK version used to build the Android libretro core to 29.x
Technical
- The MXE build is now compiled using an LLVM+Clang based build environment, replacing the previous GCC-based stack. | @OpenSauce04 #2392
- Huge thanks to @kleisauke, who for about a year and a half has been thanklessly maintaining an unofficial LLVM MXE plugin in a GitHub repository with only a single star. Without their work, making this happen would have taken much longer than it did.
- Added copyright years to all source code license headers. | @PabloMK7 #2415
- Implemented a workaround for a current compiler bug in MSVC. | @PabloMK7 #2410
- Added a new CMake option
CITRA_ADDRESS_SANITIZE. | @PabloMK7 #2402
FreeBSD
- When building on FreeBSD, system libusb is now always used due to being bundled with the OS. | @sonphantrung #2281
2126.1-alpha1
- Limitation des sauvegardes à la version d'Azahar qui les a créées, affichant un message d'erreur au chargement.
- Augmentation maximale de l'échelle de résolution interne à 18x (7200x4320).
- Suppression des crashes liés aux textures Vulkan, notamment dans Monster Hunter 4 Ultimate.
- Correction des lag dans Super Smash Bros 4 et Mini Mario & Friends: Amiibo Challenge.
- Fix des problèmes de son (crackling) lors de changements de volume, notamment dans le menu Home.
- Activation des éléments d'interface Liquid Glass sur macOS 26.
- Correction des connexions réseau locales (ex. : 3DS physique) sur macOS 27.
⚠️Important Alpha Information⚠️
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
All
- Save states are now locked to the version of Azahar that they were created with. | @PabloMK7 #2394
- Attempting to load a save state from a different Azahar version will now display an error message explaining this restriction, and will also display the version of Azahar that the save state was originally created with, recommending temporarily downgrading to retrieve progress using the in-game save functionality if necessary.
- This does not limit save state usage compared to previous behaviour. Before this change, loading a save state from a previous version of Azahar would just crash the emulator. This change now gracefully shows a message instead.
- Fixed an issue where it was possible for texture surfaces to be deleted while in use, especially at larger internal resolution settings. | @Wunkolo #2407
- This change fixes Vulkan related crashes in many different games and situations. Most notably, when starting missions in Monster Hunter 4 Ultimate.
- The highest available internal resolution scaling setting has been increased from 10x (4000x2400) to 18x (7200x4320). | @72374 #1906
- Implemented a fix for a crash in Teenage Mutant Ninja Turtles: Danger of the Ooze when using the Vulkan renderer due to inaccurate handling of the rasterizer cull mode being set to an unusual value. | @PabloMK7 #2396
- Fixed an issue which caused excessive lag in the character select screen for Super Smash Bros 4. | @PabloMK7 #2412
- Fixed an issue which caused excessive lag in Mini Mario & Friends: Amiibo Challenge when walking on diagonal surfaces. | @PabloMK7 #2412
- Fixed a regression which caused the 3DS friends menu to crash when opened. | @PabloMK7 #2412
- Implemented optimizations to GPU command list processing which save 0.5-1ms of processing time per frame on average. | @PabloMK7 #2318
- Implement geometry shader output register banking, which fixes a lot of SEGA 3D Classics games without the need of per-game patches. | @PabloMK7 #2338
- The mentioned games still present other rendering issues that need to be fixed in future versions of the emulator.
- Fix floating point denormal accuracy, which fixes various rendering issues in several games. | @Wunkolo #2350
- Fixed an issue where the 3DS Internet Browser would freeze due to incorrect core rescheduling behaviour. | @PabloMK7 #2370
- Implemented an improvement to emulated audio handling which fixes crackling sounds which an audio source's volume is changed. @Grayforz2468 #2409
- Most notable example is the Home Menu no longer having crackling music.
- Fixed an issue in the Vulkan renderer related to the handling of disabled cubemap texture units. | @Wunkolo #2406
- This brings over a fix which was previously applied to the OpenGL renderer in a previous update.
- Fixed an invalid memory access issue related to uds beacons. May fix undiscovered issues in certain multiplayer games. | @PabloMK7 #2403
Windows (MXE)
- Fixed crash which could occur when trying to launch any app with the Vulkan renderer while using the MXE build. | @OpenSauce04 #2392
- Fixed an issue where frame pacing could be inconsistent when using the MXE build. | @OpenSauce04 #2392
Desktop
- The minimum motion control sensitivity value has been reduced from 0.01 to 0.001. | @ParadiseOfMagic #2383
Linux
- Implemented a measure to help avoid having a missing application icon with certain desktop environment setups. | @Kyuyrii #1727
Android
- Upgraded target Android SDK from Android 15 (35) to Android 17 (37). | @OpenSauce04 #2416
- Fixed various edge-case crashes related to surface handling which could occur at game boot, during screen rotation, during app suspension, or during save state loading. | @PabloMK7 #2425
- Fixed an issue where debug builds of Azahar on Android would instantly crash due to a logic error relating to configuration validation. | @PabloMK7 #2398
- Fixed an issue where, if a 3DS application closed itself or encountered a fatal error and the user selected "Abort", the emulator would crash instead of returning to the application menu. | @PabloMK7 #2399
macOS
- Enabled Liquid Glass interface elements on macOS 26. | @OpenSauce04 #2429
- Fixed an issue when using macOS 27 where connecting to local network devices such as a real 3DS would always fail (e.g. Artic Base, system files setup). | @OpenSauce04 #2428
libretro
- "Stereoscopic 3D Mode" and "Stereoscopic 3D Depth" settings are now available for the libretro core. | @XenuIsWatching #2339
Technical
- The MXE build is now compiled using an LLVM+Clang based build environment, replacing the previous GCC-based stack. | @OpenSauce04 #2392
- Huge thanks to @kleisauke, who for about a year and a half has been thanklessly maintaining an unofficial LLVM MXE plugin in a GitHub repository with only a single star. Without their work, making this happen would have taken much longer than it did.
- Added copyright years to all source code license headers. | @PabloMK7 #2415
- Implemented a workaround for a current compiler bug in MSVC. | @PabloMK7 #2410
- Added a new CMake option
CITRA_ADDRESS_SANITIZE. | @PabloMK7 #2402
2126.0
- Amélioration expérimentale de l'émulation GPU avec simulation des temporisations 3DS, désactivée par défaut, améliorant Luigi’s Mansion 2 et Super Mario 3D Land.
- Correction des fichiers .z3dsx compressés avec RomFS intégré ne se chargeant pas, et compatibilité descendante des fichiers système.
- Correction des écrans de démarrage bloqués pour certains homebrews et des problèmes de texture cubemap dans Brain Age: Concentration Training.
- Correction des captures d’écran avec canaux de couleur inversés sur certaines configurations matérielles.
- Ajout d’un paramètre pour désactiver l’affichage des frames dupliquées et d’une option pour simuler des écouteurs branchés.
- Correction des crashes liés aux vertex arrays invalides (ex. Mario & Luigi: Superstar Saga) et des erreurs HTTPC dans Miiverse.
- Prise en charge de l’API de remplacement d’URL pour Pretendo Network Nimbus.
- Correction des problèmes graphiques dans Monster Hunter et des remplissages colorés avec le rendu Vulkan.
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.
- This change improves emulation accuracy by more closely mirroring the behaviour of real hardware.
- 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.
- Fixes compressed 3DSX files (
- 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 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
- Fixed a possible integer overflow issue relating to custom Luma3DS mapping + optimized implementation. | @0x48kirneh #2202
- Implemented APT:MapProgramIdForDebug. | @PabloMK7 #2224
- Fixed handling of APT communication between applications. | @DaniElectra #2225
- This fixes an issue in the Miiverse posting applet.
- Fixed behaviour of HTTPC:GetRequestState when the request still has pending post data. | @PabloMK7 #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 #2234
- Fixed a crash on color fill when using the Vulkan Renderer. | @capito27 #2241
- Disabled PICA debug functionality on all platforms, with it now being a configurable option. | @PabloMK7 #2254
- Fixed an issue related to fill surface downloading, which could cause graphical bugs in some edge cases. | @PabloMK7 #2270
- Implemented APT::GetAppletProgramInfo. | @PabloMK7 #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 #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 #2272
- Improvements to the accuracy of the GSP service, fixing issues relating to suspending applications, posting to Miiverse, and Donkey Kong Country Returns. | @PabloMK7 #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 #1881
- When using multiplayer rooms, it is now possible to set "No Preference" as the preferred game. | @PabloMK7 #2296
- Fixed an issue where auto-mapping could behave incorrectly with some controllers. | @DavidRGriswold #2317
- Assorted minor fixes relating to analog input. | @DavidRGriswold #2348
Android
- Added multiplayer room functionality. | Kleidis, @rtiangha, @Gamer64ytb, @weihuoya, @PabloMK7 #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.
- This change includes most of the multiplayer functionality found in the desktop version of 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 #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).
- Fixed an issue where attempting to access files in the Download directory (e.g. CIA files) could sometimes fail after performing certain actions. | @OpenSauce04 #2385
- Added a new "Combo Button" to the on-screen controller overlay which presses multiple buttons at the same time when pressed. @ADAS2024 #1244 #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 #1385
- Fixed several issues related to the "Adjust Scale" menu. | @OpenSauce04 #2256
Android (vanilla)
- Added an in-app toggleable update checker which runs when Azahar starts, functioning the same way as the desktop version. | @OpenSauce04 #2265
Desktop
- Implemented a CLI (command line interface) for Azahar's compression functionality via the new
-cand-xoptions. | @OpenSauce04 #2084- See
azahar --helpfor more info.
- See
- Various improvements to controller integration with Azahar's desktop frontend, including controller hotkeys. | @DavidRGriswold #1717
- Fixed some hotkeys not working correctly when using the Separate Windows screen layout. | @DavidRGriswold #1967
- After uninstalling an app, update or DLC, the game list is now refreshed. | @andrey545454 #2237
- Adjusted "Open Azahar Folder" menubar option to now include variants "NAND Folder" and "SDMC Folder". | @PabloMK7 #2279
- Fixed the Outer Right Camera setting incorrectly reading its value from the Inner Camera Flip setting. | @PabloMK7 #2303
- Fixed an issue related to clearing bindings for hotkeys bound to controllers. | @DavidRGriswold #2325
- Slightly adjusted tooltip for "Disable Right Eye Rendering" setting for increased clarity. | @72374 #2284
Windows
- Introduced the new "MXE" build variant previously discussed in an announcement on our Discord server. | @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.
- 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
- For the following languages, these UI strings currently remain untranslated as before due to no translation being available for use in upstream Qt:
macOS
- Fixed an issue where SDMC filenames which contain unicode characters could appear and behave partially corrupted within emulated applications. | @RigleGit #2079
- Fixed several minor issues relating to MoltenVK/Metal. | @sergeymild #2149
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.
Docker
- Distribute an ARM64 Docker image binary. | @OpenSauce04 #2151
Technical
- The
USE_DISCORD_PRESENCECMake option has been renamed toENABLE_DISCORD_RPC. Downstream users/maintainers should compensate for this accordingly. | @OpenSauce04 #2216 - The
ENABLE_QT_TRANSLATIONCMake option is now enabled by default, addingqt6-tools-devor 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 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 #2183
- Fixed a compilation error when building in debug mode. | @Wunkolo #2132
- Fixed an issue which prevented the azahar-room Dockerfile from building with Podman. | @OpenSauce04 #2151
- Added debug scopes to OpenGL renderer rasterizer and texture runtime. | @Wunkolo #2133
- Extensive Kotlin codebase formatting cleanup + new formatting/style enforcement in CI via ktlint. | @OpenSauce04 #2204
- 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_lupdatecall. | @OpenSauce04 #2071 - Updated NDK and AGP to more recent versions. | @OpenSauce04 #2068
- Fixed a compilation issue when building with MSYS2 due to upstream package changes. | @PabloMK7 #2236
- Fixed a potential build failure due to a missing include. | @asyync1024 #2232
- Fixed a build failure when attempting to build the libretro core with MSVC due to a malformed switch case. | @XenuIsWatching #2267
- Updated NDK used to build Android libretro core to r27d. | @cscd98 #2298
- Changed all internal references to
azahar_libretroto instead refer tocitra_libretroto follow pre-existing project convention. | @OpenSauce04 #2304- The compiled library filename remains unchanged:
azahar_libretro.*.
- The compiled library filename remains unchanged:
- 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-rc5
- Refonte du traitement des accès au système de fichiers pour les fichiers spéciaux (comme les Z3DS), préparant les futures évolutions de la version 2127.
- Correction du chargement des fichiers .z3dsx compressés avec un RomFS intégré, auparavant défaillants.
- Correction de l’inversion des étiquettes "Old 3DS setup" et "New 3DS setup" dans le menu de configuration des fichiers système.
⚠️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] This changelog is relative to 2126.0-rc4. You can find the previous changelog here.
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.
- 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.
- Fixes compressed 3DSX files (
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
- Correction d’un plantage lors de l’utilisation d’un contrôleur avec pavé tactile physique (ex. DualShock).
- Résolution d’un blocage à l’ouverture avec un contrôleur PS4/PS5 connecté.
- Correction des problèmes d’auto-mappage pour certains contrôleurs.
- Fixes mineurs liés aux entrées analogiques (centrage, déclencheurs).
⚠️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] This changelog is relative to 2126.0-rc3. You can find the previous changelog here.
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
- Ajout de l'option "No Preference" pour définir un jeu préféré dans les salles de multiplayer, corrigant les plantages lors de la création ou de la connexion à des salles privées sous Android.
- Correction d’un crash lié à une adresse de tableau de sommets invalide, résolvant notamment un problème dans les crédits de Mario & Luigi: Superstar Saga.
- Fix d’un crash dû à l’absence d’un identifiant de titre d’applet eShop pour certaines applications.
- Correction de la configuration "Outer Right Camera" qui lisait incorrectement la valeur de "Inner Camera Flip".
- Mise à jour de la version du NDK pour la construction du cœur Android libretro à r27d.
⚠️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] 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.
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_libretroto instead refer tocitra_libretroto follow pre-existing project convention. | @OpenSauce04 #2304- The compiled library filename remains unchanged:
azahar_libretro.*.
- The compiled library filename remains unchanged:
- 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
- Amélioration majeure de l'émulation GPU avec une meilleure gestion des interruptions et des timings, désactivée par défaut mais améliorant Luigi’s Mansion 2 et Super Mario 3D Land.
- Correction des problèmes de couleurs dans les captures d’écran sur certaines configurations système.
- Correction des fichiers SDMC contenant des caractères Unicode sur macOS, évitant les comportements corrompus.
- Fix des bugs mineurs liés à MoltenVK/Metal pour une meilleure stabilité sur Apple Silicon.
- Ajout d’un paramètre pour simuler des écouteurs branchés dans l’émulation 3DS.
- Suppression de la duplication de frames pour les logiciels de capture vidéo.
⚠️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 #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.
- This change improves emulation accuracy by more closely mirroring the behaviour of real hardware.
- 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 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
- Fixed a possible integer overflow issue relating to custom Luma3DS mapping + optimized implementation. | @0x48kirenh #2202
- Implemented APT:MapProgramIdForDebug. | @PabloMK7 #2224
- Fixed handling of APT communication between applications. | @DaniElectra #2225
- This fixes an issue in the Miiverse posting applet.
- Fixed behaviour of HTTPC:GetRequestState when the request still has pending post data. | @PabloMK7 #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 #2234
- Fixed a crash on color fill when using the Vulkan Renderer. | @capito27 #2241
- Disabled PICA debug functionality on all platforms, with it now being a configurable option. | @PabloMK7 #2254
- Fixed an issue related to fill surface downloading, which could cause graphical bugs in come edge cases. | @PabloMK7 #2270
- Implemented APT::GetAppletProgramInfo. | @PabloMK7 #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 #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 #2272
- Improvements to the accuracy of the GSP service, fixing issues relating to suspending applications, posting to Miiverse, and Donkey Kong Country Returns. | @PabloMK7 #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 #1881
Android
- Added multiplayer room functionality. | Kleidis, @rtiangha, @Gamer64ytb, @weihuoya, @PabloMK7 #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.
- This change includes most of the multiplayer functionality found in the desktop version of 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 #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 #1244 #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 #1385
- Fixed several issues related to the "Adjust Scale" menu. | @OpenSauce04 #2256
Android (vanilla)
- Added an in-app toggleable update checker which runs when Azahar starts, functioning the same way as the desktop version. | @OpenSauce04 #2265
Desktop
- Implemented a CLI (command line interface) for Azahar's compression functionality via the new
-cand-xoptions. | @OpenSauce04 #2084- See
azahar --helpfor more info.
- See
- Various improvements to controller integration with Azahar's desktop frontend, including controller hotkeys. | @DavidRGriswold #1717
- Fixed some hotkeys not working correctly when using the Separate Windows screen layout. | @DavidRGriswold #1967
- After uninstalling an app, update or DLC, the game list is now refreshed. | @andrey545454 #2237
- Adjusted "Open Azahar Folder" menubar option to now include variants "NAND Folder" and "SDMC Folder". | @PabloMK7 #2279
Windows
- Introduced the new "MXE" build variant previously discussed in an announcement on our Discord server. | @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.
- 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
- For the following languages, these UI strings currently remain untranslated as before due to no translation being available for use in upstream Qt:
macOS
- Fixed an issue where SDMC filenames which contain unicode characters could appear and behave partially corrupted within emulated applications. | @RigleGit #2079
- Fixed several minor issues relating to MoltenVK/Metal. | @sergeymild #2149
Docker
- Distribute an ARM64 Docker image binary. | @OpenSauce04 #2151
Technical
- The
USE_DISCORD_PRESENCECMake option has been renamed toENABLE_DISCORD_RPC. Downstream users/maintainers should compensate for this accordingly. | @OpenSauce04 #2216 - The
ENABLE_QT_TRANSLATIONCMake option is now enabled by default, addingqt6-tools-devor 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 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 #2183
- Fixed a compilation error when building in debug mode. | @Wunkolo #2132
- Fixed an issue which prevented the azahar-room Dockerfile from building with Podman. | @OpenSauce04 #2151
- Added debug scopes to OpenGL renderer rasterizer and texture runtime. | @Wunkolo #2133
- Extensive Kotlin codebase formatting cleanup + new formatting/style enforcement in CI via ktlint. | @OpenSauce04 #2204
- 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_lupdatecall. | @OpenSauce04 #2071 - Updated NDK and AGP to more recent versions. | @OpenSauce04 #2068
- Fixed a compilation issue when building with MSYS2 due to upstream package changes. | @PabloMK7 #2236
- Fixed a potential build failure due to a missing include. | @asyync1024 #2232
- Fixed a build failure when attempting to build the libretro core with MSVC due to a malformed switch case. | @XenuIsWatching #2267
2125.1.3
- Correction majeure d’un blocage instantané au démarrage sur macOS, lié à la version du système et aux données utilisateur.
- Retour en arrière d’une correction pour éviter les avertissements du linker lors de la compilation avec la présence riche Discord.
- Modifications dans dynarmic pour résoudre un problème de build causé par des mises à jour des paquets MSYS2.
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
- Correction de la détection incorrecte de la langue système pour l’interface utilisateur, avec traduction des messages par défaut de Qt pour la plupart des langues.
- Activation forcée du rendu Vulkan sur les appareils Android utilisant ANGLE pour éviter des défauts visuels majeurs avec OpenGL.
- Améliorations des fonctionnalités et options liées aux écrans secondaires sur Android.
- Correction d’un problème de démarrage en noir pour certains logiciels homebrew anciens.
- Correction d’un bug lié aux unités de textures cubemap non activées (affectant Brain Age: Concentration Training).
- Correction d’un problème graphique dans les jeux Monster Hunter via ajustement du comportement des stubs de gaz pour le rendu Vulkan.
- Correction de plusieurs problèmes mineurs liés à MoltenVK/Metal sur macOS.
⚠️Important Alpha Information⚠️
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
- For the following languages, these UI strings currently remain untranslated as before due to no translation being available for use in upstream Qt:
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_PRESENCECMake option has been renamed toENABLE_DISCORD_RPC. Downstream users/maintainers should compensate for this accordingly. | @OpenSauce04 #2216 - The
ENABLE_QT_TRANSLATIONCMake option is now enabled by default, addingqt6-tools-devor 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 if it wasn't being used. | @crueter #2183
- Fixed a compilation error when building in debug mode. | @Wunkolo #2132
- Fixed an issue which prevented the azahar-room Dockerfile from building with Podman. | @OpenSauce04 #2151
- Added debug scopes to OpenGL renderer rasterizer and texture runtime. | @Wunkolo #2133
- Extensive Kotlin codebase formatting cleanup + new formatting/style enforcement in CI via ktlint. | @OpenSauce04 #2204
2126.0-alpha1
- Correction des fichiers SDMC contenant des caractères Unicode, évitant leur corruption dans les applications émulées sous macOS.
- Amélioration de la lisibilité des messages d'erreur pour les utilisateurs.
- Implémentation d'une file d'interruption GPU et d'une émulation des temporisations GPU, améliorant l'exactitude de l'émulation et rendant certains jeux jouables sans options de contournement.
- Ajout d'une option permettant de simuler la présence de casque audio branché dans le système émulé.
⚠️Important Alpha Information⚠️
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. | @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
-cand-xoptions. | @OpenSauce04 #2084- See
azahar --helpfor more info.
- See
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.
- This change improves emulation accuracy by more closely mirroring the behaviour of real hardware.
- 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_lupdatecall. | @OpenSauce04 #2071 - Updated NDK and AGP to more recent versions. | @OpenSauce04 #2068
2125.1.2
- Ajout de l'attestation et du Software Bill of Materials pour sécuriser les assets de distribution, rendant les releases immuables et vérifiables via GitHub CLI ou un script bash dédié.
- Réduction des tailles de fichiers des cœurs libretro (notamment Android) grâce au stripage des binaires, sans impact sur le fonctionnement.
- Optimisation des temps de compilation via l’ajout de EXCLUDE_FROM_ALL dans les cibles CMake pour certaines configurations non standard.
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
Immutableat 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". 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
sha256hashes 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.
- Users should be able to verify the validity of azahar binaries using the GitHub Cli. For example:
- 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-releasebash 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.
- 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
Technical
- Added
EXCLUDE_FROM_ALLto 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
- Correction d’un bug régressif sur Windows où les coins des fenêtres semblaient arrondis en plein écran.
- Résolution d’un plantage affectant certains jeux dus à une erreur dans le traitement des textures d’ombre.
- Remplacement de std::powf par std::pow pour améliorer la compatibilité des environnements de build.
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::powffunction in 2125.1 to usestd::powinstead, restoring wider build environment compatibility. | @cobalt2727 #2045 - Miscellaneous OpenBSD build fixes. | @OpenSauce04 #2052
2125.1
- Ajout de l'émulation de la LED de notification du 3DS, visible uniquement dans l'interface desktop.
- Correction des modes de mélange de couleurs défaillants sur le backend OpenGL, éliminant un carré noir en bas à droite dans certains jeux.
- Mise en œuvre de la limitation du temps CPU syscore pour reproduire le comportement matériel réel, améliorant la stabilité des modules LLE comme BOSS.
- Activation du module LLE BOSS par défaut via un paramètre dédié pour les fonctionnalités en ligne.
- Correction des erreurs de retour incorrectes dans les fonctions getaddrinfo/getnameinfo pour les applications émulées.
- Optimisation de l'état SETEMIT dans GeometryEmitter pour améliorer les performances des jeux utilisant des shaders géométriques.
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
syscoreCPU time limiting to match real hardware behaviour. | @PabloMK7 #1934- Makes emulated applications properly use the
syscorewithout starving LLE system applets, which fixes several subtle timing issues. - Most notably, fixes stability issues caused by having the
BOSSLLE module enabled.
- Makes emulated applications properly use the
- The
BOSSLLE 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/getnameinfofunctions. | @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_KEYBLOBCMake 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_OAKNUTCMake 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.
Réagir sur le forum
Une question, un retour d’expérience ? Ouvrez la discussion sur le forum.