https://github.com/nba-emu/NanoBoyAdvance

A cycle-accurate Nintendo Game Boy Advance emulator.
https://github.com/nba-emu/NanoBoyAdvance

cycle-accurate emulator emulator-development gameboy-advance gameboy-advance-emulator

Last synced: 2 months ago
JSON representation

A cycle-accurate Nintendo Game Boy Advance emulator.

• Host: GitHub
• URL: https://github.com/nba-emu/NanoBoyAdvance
• Owner: nba-emu
• License: gpl-3.0
• Created: 2015-08-06T00:44:36.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-04-12T22:02:12.000Z (2 months ago)
• Last Synced: 2024-04-13T07:20:31.455Z (2 months ago)
• Topics: cycle-accurate, emulator, emulator-development, gameboy-advance, gameboy-advance-emulator
• Language: C++
• Homepage:
• Size: 3.39 MB
• Stars: 916
• Watchers: 35
• Forks: 48
• Open Issues: 64
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-gbadev - NanoBoyAdvance - GBA emulator with high accuracy, especially in timing and CPU emulation. Does not have debugging features. (Emulators / Other places)
• awesome-emulators-android - NanoBoyAdvance
• awesome-emulators - NanoBoyAdvance
• awesome-gba-dev-zh - NanoBoyAdvance - GBA 仿真器精度高，特别是在时序和 CPU 仿真方面。没有调试功能。 (模拟器)

README

        
NanoBoyAdvance


![license](https://img.shields.io/github/license/nba-emu/NanoBoyAdvance)

![build](https://img.shields.io/github/actions/workflow/status/nba-emu/NanoBoyAdvance/build.yml?branch=master)

[![discord](https://img.shields.io/discord/969218483873251338?logo=discord&label=discord)](https://discord.gg/4NnUjsf7Am)

NanoBoyAdvance is a cycle-accurate Game Boy Advance emulator.


It aims to be as accurate as possible, while also offering enhancements such as

improved audio quality.


## Features

- Very high compatibility and accuracy (see [Accuracy](#accuracy))

- HQ audio mixer (for games which use Nintendo's MusicPlayer2000 sound engine)

- Post-processing options (color correction, xBRZ upscaling and LCD ghosting simulation)

- Save State support (10x save slots available)

- Game controller support (buttons and axises can be remapped)

- Loading ROMs from archives (Zip, 7z, Tar and limited RAR[^1] support)

- RTC emulation

- Solar Sensor emulation (for example: for Boktai - The Sun is in Your Hand)

- Debug tools: PPU palette, tile, background and sprite viewers

[^1]: RAR 5.0 is currently not supported.

## Running

Download a recent [development build](https://nightly.link/nba-emu/NanoBoyAdvance/workflows/build/master) or the last [stable release](https://github.com/nba-emu/NanoBoyAdvance/releases).

Upon loading a ROM for the first time you will be prompted to assign the Game Boy Advance BIOS file.  

You can [dump](https://github.com/mgba-emu/bios-dump/tree/master/src) it from a real console (accurate) or use an [unofficial BIOS](https://github.com/Nebuleon/ReGBA/blob/master/bios/gba_bios.bin) (less accurate).

## Accuracy

A lot of research and attention to detail has been put into developing this core and making it accurate.

- Cycle-accurate emulation of most components, including: CPU, DMA, timers, PPU and Game Pak prefetch

- Passes all AGS aging cartridge tests (NBA was the first public emulator to achieve this)

- Passes most tests in the [mGBA test suite](https://github.com/mgba-emu/suite) (see [mGBA suite comparison](docs/ACCURACY.md#mGBA-suite-comparison) for more details)

- Passes [ARMWrestler](https://github.com/destoer/armwrestler-gba-fixed), [gba-suite](https://github.com/jsmolka/gba-tests) and [FuzzARM](https://github.com/DenSinH/FuzzARM) CPU tests

- Very high compatibility, including games that require emulation of peculiar hardware edge-cases (see [Game compatibility](docs/ACCURACY.md#Game-compatibility))

## Compiling

See [COMPILING.md](docs/COMPILING.md) in the `docs` folder.

## Acknowledgements

- Martin Korth: for [GBATEK](http://problemkaputt.de/gbatek.htm), a good piece of hardware documentation.

- [endrift](https://github.com/endrift): for hardware [research](http://mgba.io/tag/emulation/) and her excellent [test suite](https://github.com/mgba-emu/suite).

- [destoer](https://github.com/destoer), [Noumi](https://github.com/noumidev), [Zayd](https://github.com/GhostRain0) and [Sky](https://github.com/skylersaleh): for hardware research and tests, countless discussions and being good friends.

- Pokefan531 and hunterk: for the default GBA color correction algorithm

- Talarubi and Near: for [higan's GBA color correction algorithm](https://near.sh/articles/video/color-emulation)

- DeSmuME team and Hyllian: xBRZ upscaling code

## Sister Projects

- [Panda3DS](https://github.com/wheremyfoodat/panda3DS): A new HLE Nintendo 3DS emulator

- [Dust](https://github.com/Kelpsyberry/dust/): Nintendo DS emulator for desktop devices and the web

- [Kaizen](https://github.com/SimoneN64/Kaizen): Experimental work-in-progress low-level N64 emulator

- [SkyEmu](https://github.com/skylersaleh/SkyEmu/): A low-level GameBoy, GameBoy Color, GameBoy Advance and Nintendo DS emulator that is designed to be easy to use, cross platform and accurate

## Copyright

NanoBoyAdvance is Copyright © 2015 - 2024 fleroviux.


It is licensed under the terms of the GNU General Public License (GPL) 3.0 or any later version. See [LICENSE](LICENSE) for details.

Game Boy Advance is a registered trademark of Nintendo Co., Ltd.