NanoBoyAdvance
NanoBoyAdvance is an open-source Game Boy Advance emulator written in C++ and designed for accurate emulation, compatible with macOS 10.15 and later versions through SDL2.
This software no longer receives updates. Its last known release dates from May 10, 2026. Check that it still works with your version of macOS.
NanoBoyAdvance is an open-source emulator dedicated to Game Boy Advance (GBA), developed in C++ with a cycle-accurate approach to ensure maximum fidelity. It caters to demanding players with advanced features such as enhanced audio quality (support for the MusicPlayer2000 engine), post-processing options (color correction, xBRZ upscaling, LCD ghosting simulation), and a state save system with 10 slots.
On macOS, it runs via SDL2 and is compatible with recent versions (from macOS 10.15 onwards). The emulator also includes debugging tools (palette, tile, background, and sprite visualization) and precise hardware component emulation (CPU, DMA, timers, PPU), validated by rigorous tests (AGS, mGBA, ARMWrestler). Configuration requires CMake, SDL3, and Qt6, available via Homebrew on macOS.
Last updated:
Platforms
Architecture
Mac OS X - macOS
Apple Silicon
64-bit
SDL Library
Download and links
- Download NanoBoyAdvance
- Official website
- Source code 1 312 GitHub stars
- License : GPL-3.0
Version history
1.8.3
- Ajout de modes de fast-forwarding (2x, 4x, 8x) et option illimitée pour accélérer l’exécution.
- Passage complet à Qt 6 pour la plateforme, avec suppression des builds macOS Intel.
- Correction du lag des contrôles sur macOS pour une meilleure réactivité.
- Suppression des liens cassés et des fichiers de compilation séparés, documentation centralisée dans le README.
This is a patch release updating NanoBoyAdvance to Qt 6.
Please backup your save files before updating to be safe.
Changelog
- Core: Improved fast-forwarding, adding 2x, 4x and 8x options alongside infinite
- UI: Set default filter to nearest
- Platform: Upgrade to Qt 6
- Platform: Fix controller lag on macOS
- CI: Pivot Windows builds to MSVC, remove macOS Intel builds
- Remove broken links from README, remove COMPILING and move its instructions to README
- Update dependencies
1.8.2
- Ajout d’un shader LCD1x pour améliorer l’affichage de l’interface utilisateur.
- Correction d’un conflit logique dans le bus LDM^ en mode utilisateur ARM.
- Prise en charge des accès hors limites lors du basculement entre modes CPU invalides.
- Optimisation des lectures des registres GPR et SPSR dans le processeur ARM.
- Optimisation des opérations arithmétiques LSL, LSR, ASR, ROR pour le CPU ARM.
- Autorisation des ticks CPU internes pendant les transitions CPUDMA.
Please backup your save files before updating to be safe.
Changelog
- UI: implement LCD1x shader (thanks @DestinyXZ9)
- ARM: implement multiplication carry algorithm (thanks @zaydlang, @calc84maniac)
- ARM: fix LDM^ bus conflict logic breaks in user mode
- ARM: fix out-of-bounds accesses when switching in or out of an invalid CPU mode
- ARM: optimize GPR and SPSR reads
- ARM: optimize LSL, LSR, ASR and ROR arithmetic
- DMA: allow CPU internal ticks during CPUDMA transition cycles
- PPU: correctly reset OBJ mosaic Y counter (thanks @j-mattsson)
1.8.1
- Ajout d’une option pour suspendre l’émulateur quand la fenêtre est inactive.
- Correction de la réponse aux changements d’entrée dans le visionneur de sprites en pause.
- Remplacement de QOpenGLWidget par QWidget pour améliorer la stabilité graphique.
- Réparation du menu des niveaux de capteur solaire, défaillant depuis la version 1.8.0.
- Correction de la désérialisation défectueuse des directions de ports GPIO.
- Gestion des adresses corrompues d’informations d’onde dans le mode HLE du MP2K (APU).
- Remappage obligatoire des volumes PSG gauche/droite (échelle 0-7 → 1-8).
Please backup your save files before updating to be safe.
Changelog
- UI: implement an option to pause the emulator when the window is inactive
- UI: improve lack of response to input changes in the sprite viewer when the emulator is paused
- UI: replace QOpenGLWidget with QWidget (thanks @GranMinigun)
- UI: fix solar sensor level menu that has been broken in 1.8.0 (fixes #370)
- GPIO: fix broken deserialization of port directions
- APU: MP2K HLE: handle corrupted wave info addresses (fixes #362)
- APU: PSG L/R volume must be remapped from 0-7 to 1-8
- GameDB: Japanese Boktai releases have a solar sensor (thanks @raphaelr)
- Redirect stdout on Windows (thanks @GranMinigun)
1.8.0
- Ajout d’un filtre vidéo "Sharp" pour une interpolation nearest améliorée aux échelles non entières.
- Intégration de vues PPU (palettes, tuiles, arrière-plans et sprites) dans l’interface utilisateur.
- Correction de la perte d’entrée introduite en 1.7.1 et bascule vers l’API SDL joystick pour une meilleure compatibilité des manettes.
- Suppression de l’émulation du mode "Zombie" (inexistant sur GBA) et amélioration des calculs audio (réverbération, enveloppes, FIFO).
- Fix de l’affichage des pixels de sprites d’une scanline précédente dans la dernière scanline.
- Correction des mosaïques horizontales/verticales des sprites et gestion plus précise des changements mid-frame.
- Simulation d’un délai d’écriture EEPROM (~6 ms) et émulation du registre interne Mask ROM pour les cartouches.
- Suppression des artefacts audio lors du resampling (Sinc et Cosine) et correction des clics.
Please backup your save files before updating to be safe.
Changelog
- UI: implement "Sharp" video filter for better nearest interpolation at non-integer scales (thanks GranMinigun)
- UI: implemented PPU viewers for palettes, tiles, backgrounds and sprites
- UI: add an option to set the audio volume
- UI: do not unpause emulator after loading a new ROM
- Input: fix input dropping regression introduced in NBA 1.7.1
- Input: move from SDL game controller to SDL joystick API (fixes broken mapping on some controllers)
- APU: MP2K HLE: interpolate envelopes and use floating-point math
- APU: MP2K HLE: implement a better reverb algorithm
- APU: MP2K HLE: add an option to force-enable reverb
- APU: remove "Zombie" mode emulation (does not appear to exist on GBA)
- APU: fix mid-note envelope frequency changes
- APU: FIFO writes should happen in place
- APU: reset FIFOs on overflow
- APU: add master-enable checks for 16-bit/32-bit IO writes
- PPU: fix sprite pixels from previous scanline displayed in the last scanline
- PPU: more accurate update of attribute buffer for OBJWIN sprites (fixes #275)
- PPU: more accurate emulation of horizontal and vertical sprite mosaic (fixes #322)
- PPU: more accurate handling of mid-frame vertical mosaic reconfiguration
- PPU: fix out-of-bounds bitmap fetches in Mode 3 to 5
- DMA: fix incorrect mapping of DMA channel to APU FIFO
- Timer: somewhat handle timer overflow during one cycle enable delay (thanks alyosha)
- Game Pak: simulate ~6 ms EEPROM device busy period after write (not yet accurate to cartridges that e.g. have been in the freezer for 30 minutes)
- Game Pak: emulate the Mask ROM internal address register
- Audio: fix clicking artifacts when using Sinc resampling
- Audio: fix incorrect liner interpolation in Cosine resampling
- PlatformCore: fixed hang when fast-forwarding while the emulator is paused
- Misc: implemented support for unicode paths
1.7.1
- Correction de requêtes de VRAM hors limites pour les tuiles de fond (PPU) et retour de bus ouvert.
- Éviter le saut vers l’événement suivant si le CPU se réveille pendant une opération DMA.
- Demande systématique d’IRQs depuis le thread de l’émulateur (pas celui appelant) pour le clavier.
- Correction des entrées de base de données pour plusieurs jeux NES Classique et Famicom Mini.
Please backup your save files before updating to be safe.
Changelog
- PPU: disallow out-of-bounds BG VRAM tile fetches and return open bus (fixes #298)
- Core: do not skip to the next event if the CPU woke up during a DMA (fixes #297)
- KeyPad: always request IRQs from the emulator (not the calling) thread (fixes #290)
- GameDB: fix entries for a bunch of Classic NES and Famicom Mini titles (fixes #302)
- IO: do not enter STOP mode when it is not implemented
- mGBA log: clear the message buffer after printing the message
- mGBA log: flush STDOUT after each message
- Catch fmt::system_error when fmt::print() fails to write to STDOUT (fixes #301)
1.7
- Ajout d’une option de mise à l’échelle entière pour l’interface utilisateur et limitation de l’échelle d’affichage.
- Accès au menu autorisé pendant le jeu en plein écran et personnalisation du dossier de sauvegarde.
- Compatibilité des sauvegardes avec mGBA 0.10.0+ et support basique de son interface de journalisation.
- Réécriture du PPU pour une précision quasi-cycle-exacte, incluant la prise en charge du registre GREENSWAP et du 6ᵉ bit vert pour le mélange.
- Correction d’un retard mineur dans l’exécution ARM et gestion précise des instructions SWP/SWPB et du bus.
- Optimisation du bus pour exécuter des cycles CPU inactifs en parallèle des transferts DMA et amélioration de la désactivation du buffer de pré-fetch.
- Correction des retards d’écriture IRQ et de la synchronisation du registre IE/IF pour le réveil du CPU.
- Mise en œuvre du timing des transferts série (SIO) et de la gestion du bit d’activation maître (APU).
This is a major release with lots of code changed. Please backup your save files before updating to be safe.
Changelog
- UI: implement a 'Use integer scaling' option
- UI: allow limiting the screen scale
- UI: allow accessing the menu during fullscreen gameplay
- UI: allow setting a custom save folder
- Core: implement save compatibility with mGBA 0.10.0+
- Core: implement basic support for the mGBA logging interface
- PPU: rewrite the PPU to be mostly cycle-accurate (fixes #241, #230, #229, #208, #141)
- PPU: implement the GREENSWAP register
- PPU: use the 6-th green channel bit during blending
- PPU: round the blending result to the nearest integer
- ARM: fix a minor timing oversight in ARM mode
- ARM: SWP and SWPB should lock the bus (no DMA interleave is possible)
- ARM: do not force-align mis-aligned PC in ARM mode
- Bus: allow the CPU to execute idle cycles in parallel to DMA
- Bus: more accurately emulate disabling the prefetch buffer
- Bus: force the first CPU access after a DMA to be non-sequential
- Bus: implement penalty for ROM code access during the last ROM prefetch cycle (fixes #203)
- IRQ: delay IO writes by one cycle
- IRQ: delay update of the IE&IF condition for unhalting the CPU
- SIO: implement basic serial transfer timing (fixes #282)
- APU: emulate the master enable bit
- APU: cancel a potentially pending event whan starting a channel (fixes #278)
- Scheduler: allow for (de)serialization of events for save states
Notes
On Linux make sure SDL2, GLEW and Qt5 are installed
1.6
- Ajout de la sélection et du remappage des manettes dans l’interface utilisateur.
- Prise en charge du chargement de ROMs depuis des archives (Zip, 7z, RAR4).
- Dépose-glisser de ROMs directement sur la fenêtre principale pour les charger.
- Correction des plantages occasionnels lors du chargement d’une ROM en cours d’exécution.
- Initialisation correcte de l’état WIN0/1 après un reset du PPU (fixe un problème graphique).
Changelog
- UI: implement game controller selection and remapping
- UI: enable loading ROMs from archives (Zip, 7z, RAR4)
- UI: enable loading ROMs via Drag & Drop onto the main window
- UI: fix occasional crashes when loading a ROM while the emulator is running
- UI: fix screen clearing and stop audio if ROM could not be loaded
- UI: unpause the emulator if a ROM is loaded
- UI: add an option to unlock the aspect ratio
- Core: implement Solar Sensor emulation (for Boktai I and II)
- Core: implement experimental save state support
- Save Memory: automatically detect EEPROM save sizes (closes #219)
- ARM: fix switch between FIQ and non-user/system modes
- PPU: delay H-blank IRQs by four cycles (fixes #89, fixes #175)
- PPU: disable VRAM mirror at 06018000h in bitmap modes (fixes #102)
- PPU: latch BGX/Y writes at the beginning of each scanline (fixes #176)
- PPU: delay scanline rendering by 32 cycles (fixes #93)
- PPU: properly initialise WIN0/1 state after reset (fixes #223)
- PPU: 2D OBJs should wraparound horizontally (fixes #224)
- PPU: move rendering to a secondary thread for better performance
- PPU: improve DMA3 video transfer timing
- PPU: respect WININ/WINOUT if Alpha OBJ does not have a blend source
- IRQ: add 16-bit IO access handlers to avoid scheduling multiple events
- IRQ: assign (preliminary) priorities to events for IRQ raise and acknowledge/disable events
- Timer: be explicit about IO write event order
- RTC: enable 24h-mode by default (fixes #136)
- RTC: multiple small fixes and accuracy improvements
Notes
On Linux make sure SDL2, GLEW and Qt5 are installed
1.5
- Correction de l’initialisation du bit 4 des registres CPSR/SPSR sur ARM pour résoudre des problèmes dans Banjo-Kazooie: Grunty's Revenge.
- Prise en compte d’une pénalité d’un cycle lors de l’accès au Game Pak avec préchargement actif et de deux cycles pour l’instruction HALT.
- Amélioration de la précision des accès DMA, notamment pour les transferts ROM to ROM, et gestion des changements du registre de contrôle pendant une transfert.
- Réajustement de l’émulation des retards d’interruption (IRQ) et ajout d’un cycle de latence pour l’application des modifications du registre de contrôle des timers.
- Application du mosaic horizontal des sprites en post-traitement sur le PPU et correction du modèle FIFO de l’APU (7 mots 32 bits au lieu de 8).
- Mise à disposition d’un build sous forme d’App Bundle pour macOS.
Linux installation instructions:
- install SDL2, GLEW and Qt5
Changelog
- ARM: force CPSR/SPSR bit 4 to one (fixes Banjo-Kazooie: Grunty's Revenge)
- Bus: Game Pak access sometimes incurs a one-cycle penalty when prefetch is active
- Bus: HALT incurs a two-cycle penalty
- DMA: make access pattern (more) accurate for
ROM to ROMand other weird DMAs. - DMA: move the second internal cycle at the end of the transfer
- DMA: handle more changes to the control register during a transfer
- IRQ: rework interrupt delay emulation (once again)
- Timer: writing to the control register takes one cycle to apply
- PPU: apply horizontal sprite mosaic as a post-process
- APU: model FIFO as a buffer of seven (not eight) 32-bit words (thanks Gericom) (fixes #101)
- APU: high bits of SOUND2CNT_L should return zero
- Input: make KEYINPUT updates atomic to avoid incorrect game resets (from the Key IRQ)
- UI: maintain a list of recently opened files for quick loading
- UI: allow loading ROMs via process arguments
- UI: add shortcuts for fullscreen and window scale
- UI: implement a workaround for the broken menu bar during fullscreen on Windows
- UI: hide the FPS counter by default and add an option to unhide it
- OpenGL: fix a black screen issue on some Intel integrated GPUs
- macOS: build NanoBoyAdvance as an App Bundle (thanks nadiaholmquist)
1.4
- Ajout d’un mélangeur audio logiciel de haute qualité pour le moteur de son MusicPlayer2000.
- Intégration d’une nouvelle interface graphique Qt avec options de post-traitement OpenGL.
- Correction du rendu des sprites à l’avance d’une scanline pour éviter des artefacts visuels.
- Correction d’un décalage dans la boucle de dessin des objets (OBJ) en PPU.
- Application de la limite de dessin OAM uniquement aux limites de la mémoire OAM, pas pixel par pixel.
- Correction de la transparence en Mode 4 de la PPU pour un rendu fidèle.
- Émulation du délai d’activation des arrière-plans (BG enable delay) dans la PPU.
- Mise à jour des registres internes (affines) X/Y uniquement si le BG est activé.
macOS installation instructions:
- install brew if you haven't already
- install Qt5 from brew:
brew install qt@5
Linux installation instructions:
- install SDL2, GLEW and Qt5
Changelog
- Audio: added a high-quality software/HLE mixer for the MusicPlayer2000 sound engine
- Platform: added a new Qt frontend with OpenGL post-processing options
- PPU: render sprites one scanline ahead (fixes #130)
- PPU: fix an off-by-one in the OBJ draw loop
- PPU: apply OAM draw limit only on OAM (instead of pixel) boundaries for now
- PPU: fix Mode4 transparency (fixes #169)
- PPU: emulate BG enable delay (fixes #94)
- PPU: update internal (affine) X/Y registers only if the BG is enabled (fixes #177)
- Memory: handle 16-bit KEYCNT writes (fixes #152)
- Memory: HALTCNT and POSTFLG should only be writable from BIOS code
- Memory: mask top two bits of the IE register
- DMA: each DMA channel should have its own memory data register (MDR)
- CPU: rework IRQ signal propagation delay
- CPU: improve IRQ exception timing
- CPU: emulate user-mode LDM bus conflict
- CPU: handle invalid CPU modes
- CPU: emulate MSR user-mode restrictions
- CPU: boot into supervisor mode instead of system mode
- CPU: handle rD=r15 edge-case in CMP/CMN/TST and TEQ
- CPU: Thumb ALU shifts now mask the shift amount
- CPU: fix unsigned multiply-long timing
- EEPROM: fix address masking
1.3
- Correction du traitement des instructions ARM CMP, CMN, TST et TEQ avec rD = 15.
- Implémentation d’un système d’IRQ pour le clavier et un stub pour les IRQ série.
- Respect du flag cascade dans le calcul de la fréquence d’échantillonnage des timers.
- Activation prioritaire des transferts DMA en cours d’exécution CPU.
- Correction des accès ROM en mode FIFO DMA et forçage des accès par mots.
- Meilleure gestion des registres internes affine et mosaïque du PPU lors de changements de modes graphiques.
- ARM: handle CMP, CMN, TST and TEQ with rD = 15
- ARM: handle mode switches when the register bank does not change.
- ARM: removed errorneous user-mode switch from LDRT/STRT opcodes.
- DMA: allow DMAs to take priority over the CPU in the middle of an instruction
- DMA: delay DMA startup by two cycles and account for 2I internal cycles
- DMA: force ROM accesses to increment source address mode
- DMA: respect source address mode setting for FIFO DMA
- DMA: force FIFO DMA to use word sized accesses
- DMA: handle manual disable (via enable flag) more gracefully
- Timer: respect cascade flag in sample rate calculation
- APU: emulate DAC enable bits (fixes #64)
- PPU: match WIN0/1 trigger logic to hardware (thanks @destoer)
- PPU: fix H-blank IRQ timing (once again)
- PPU: better handle internal affine registers when multiple BG modes are used in a single frame.
- PPU: handle invalid BG modes 6 and 7 (thanks @LadyStarbreeze)
- PPU: update internal affine & mosaic registers at the start of H-blank, not at the end.
- MMIO: do not fallthrough on SOUNDBIAS writes (fixes #125)
- Keypad: implemented keypad IRQ (thanks @destoer)
- Serial: implemented a serial IRQ stub
- SDL: always call glewInit() (fixes #129 )
- SDL: use binary directory as current working directory
1.2
- Optimisation majeure du préchargeur de mémoire GamePak et correction des IRQ retardées de quatre cycles pour résoudre James Pond.
- Correction des lectures non alignées en S16 depuis la ROM et SRAM, ainsi que des accès DMA depuis des adresses ouvertes.
- Amélioration du PPU avec gestion des priorités d’objets, correction des limites de cycles par ligne et semi-transparence.
- Ajout de surcharges de type de sauvegarde pour quatre jeux dans la base de données intégrée.
- Désactivation par défaut de la synchronisation audio et ajout d’un résémaplage BLEP pour améliorer la qualité sonore.
-
CPU: Optimized GamePak prefetch buffer emulation
-
CPU: Reading prefetched GamePak memory engages the GamePak prefetcher.
-
CPU: Delay all IRQs by four cycles (fixes James Pond)
-
CPU: Handle pipeline flush for halfword reads
-
CPU: Force next ARM instruction fetch to be sequential if the condition isn't met.
-
CPU: Optimized ADC and SBC flag calculations
-
DMA: Ignore repeat-flag for immediate DMAs
-
DMA: Mask source and destination addresses on write.
-
DMA: Properly disable non-repeating FIFO DMA (fixes #97)
-
Timer: Greatly optimized emulation efficiency, timers now are scheduled.
-
Memory: Fix unaligned S16 reads from out-of-bounds ROM
-
Memory: Allow read/write to POSTFLG register
-
Memory: Allow read from WAVE_RAM registers
-
Memory: Fix unaligned S8/S16 reads from SRAM
-
Memory: Handle DMA reads from open bus addresses (fixes #109)
-
Memory: Improved GPIO bus emulation
-
Memory: Force-align 16-bit expanded 8-bit VRAM and PRAM writes.
-
PPU: Raise H-blank IRQs after 960 cycles instead of 1006 (fixes #89)
-
PPU: Handle OBJ priority hijacking (fixes #99)
-
PPU: Respect per-scanline cycle limit for OBJ rendering (fixes #98)
-
PPU: Handle odd tile numbers in 256-color OBJs (fixes #106)
-
PPU: Emulate tile number limit for 256-color OBJs
-
PPU: Latch internal affine registers on mode switch (fixes #90)
-
PPU: Handle setting V-count setting to the current V-count value.
-
PPU: Make V-count IRQ edge-triggered
-
PPU: Fixed broken semi-transparency logic
-
APU: Clamp samples before converting to S16 format (fixes #100)
-
APU: Use BLEP resampler to improve quality of direct audio.
-
RTC: Fix off-by-one error in the day of month.
-
GameDB: Added save type override for Acrobat Kid (Japan)
-
GameDB: Added save type override for Baldur's Gate - Dark Alliance
-
GameDB: Added save type override for 007 - Everything or Nothing
-
GameDB: Added save type override for Super Monkey Ball Jr.
-
GameDB: Fixed save type override for Classic NES - Legend of Zelda
-
Common/DSP: Linearly interpolate CosineResampler lookup-table
-
Common/DSP: Added a BLEP resampler
-
Miscellaneous: Do not sync to audio by default
-
Miscellaneous: Experimental, optional hack to increase audio sample rate in games which use the M4A/Sappy sound engine. This will break games and is thus not turned on by default.
1.1
- Ajout du support des shaders GLSL pour une meilleure compatibilité graphique.
- Correction du dysfonctionnement du Vsync sur Windows et macOS.
- Correction d’un plantage en l’absence du fichier keymap.toml.
- Installation de SDL2 via Homebrew requise pour macOS.
- implemented GLSL shader support
- fix broken Vsync on Windows and presumably macOS
- fix crash when no keymap.toml is present
macOS instructions:
- You need to install SDL2 via brew:
brew install sdl2
1.0
No details for this version.
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.