Azayaka
Azayaka is a free and open-source Game Boy and Game Boy Color emulator written in C++.
Features
- Cycle-Accurate emulation.
- Console based Debugger.
- Audio emulation.
- Real-Time Clock support.
- Screen shots.
- Audio recording.
- Save states.
- Rewind.
- Disassembler(With Code/Data Log).
- Automated testing system.
- Emulates both the Game Boy(DMG) and Game Boy Color(CGB).
- Game Boy Printer.
- Link Cable(Experimental)
Accuracy
- Passes all of blargg's tests except oam_bug.
- Passes most of gekkio's Mooneye GB tests.
Cartridge Mappers
Azayaka supports the following cartridge-mappers:
- MBC1
- MBC1M
- MBC2
- MBC3
- MBC3+RTC
- MBC5
Supported Platforms
- Linux
- Mac OS
- Windows (Coming soon!)
Controls
Emulated Buttons
Note: You can map different keys to the buttons by editing Azayaka's INI file.
| Button | Key |
|---|---|
| A | Z |
| B | X |
| Start | Enter |
| Select | Space |
| Up | ↑ |
| Down | ↓ |
| Left | ← |
| Right | → |
Key Commands
| Function | Key |
|---|---|
| Turbo | Shift |
| Slow-Motion | Alt |
| Rewind | Backspace |
| Toggle Fullscreen | Ctrl+F |
| Pause/Unpause | Ctrl+P |
| Reset | Ctrl+R |
| Trigger Debugger | Ctrl+C |
| Increase Volume | Plus |
| Decrease Volume | Minus |
| Load Savestate | F1-F10 |
| Save Savestate | Ctrl + F1-F10 |
| Take Screenshot | F11 |
| Start/Stop recording Audio | F12 |
Building
Requires CMake
Dependencies
- SDL2: For the frontend.
- libpng: For PNG screenshots. If you don't have it, BMPs will be used instead.
- OpenGL: For hardware accelerated graphics. If you don't have it, SDL will be used for the rendering.
*Nix Building
mkdir build
cd build
cmake ..
make
Windows Building
Coming Soon!
Sorry, but I don't currently have a Windows Dev machine, but I should have a setup in just a couple of weeks. But in the mean time, I can't guaranty that Azayaka will compile on a Windows Box. My apologies.
Running
Running Azayaka-sdl
./Azayaka-SDL [ROM or Directory Path] [Options...]
-d, --debug Run the emulator in debug mode
-s, --scale Scales the screen by the factor given
-g, --force-gb Force the emulator into GameBoy mode
-c, --force-gbc Force the emulator into GameBoy-Color mode
-l, --link Enable GameBoy Link-Cable
-p, --printer Enable GameBoy Printer
-D, --dump-usage Saves the ROM usage(CDL) to a file
--verbose Enable verbose debugging information
--force-sdl Force the emulator to use SDL as the Video-Driver
Running Azayaka-tester
./Azayaka-tester [Test ROMs path] [Correct-Results CSV Path]
Thanks
- Shay Green for blargg's tests.
- Joonas Javanainen for Mooneye GB tests.
- Antonio Niño Díaz for TCAGBD.
- Ben Smith(binji) for his article on implementing rewind.
- To all of the authors of the emulators that I used for inspiration.
- To you, for looking at my emulator!
Copyright
Azayaka is licensed under GPL3. Copyright © 2020-2021 Zach Collins
"Game Boy" and "Game Boy Color" are trademarks of Nintendo. Azayaka is not affiliated with Nintendo in any way.