# 🔥 Hades

[](https://github.com/hades-emu/hades/actions/workflows/build.yml)
[](https://discord.com/invite/zBHkV836AK)

A Nintendo Game Boy Advance Emulator
## Screenshots
## Features
Hades is still under heavy development but it aims to have a decent balance between usability, speed and accuracy.
Currently, Hades features:
- Decent accuracy
- Game controller support
- Keys and buttons remapping
- Quick Saves (also known as Save State)
- Loading games from common archive formats (`.zip`, `.7z`, `.rar`, etc.)
- Some GPIO devices, such as:
- Real Time Clock (RTC)
- Rumble
- Shaders, such as:
- Color correction
- xBRZ scaling
- LCD effects
- Etc.
- Cheat devices, such as:
- Action Replay
- GameShark
- Codebreaker
It is the third 🥉 software emulator to pass the AGS Aging Cartridge used to test Game Boy Advance systems.
## Installation
Follow the instructions on our [official website](https://hades-emu.org/download) to download and install Hades the latest release of Hades.
## Build
To build Hades, you first need to install those dependencies:
- `meson`
- `ninja`
- `GCC`
- `SDL3`
- `OpenGL`
- `glew`
- `libarchive`
- `libcurl` (Linux and MacOS only, Windows uses WinHTTP instead)
On the latest Ubuntu, you can install all those dependencies with:
```bash
$ apt install meson ninja-build gcc libsdl3-dev libglew-dev libarchive-dev libcurl4-openssl-dev
```
Finally, to build Hades, run:
```bash
git submodule update --init --recursive
meson build
cd build
ninja
```
## Thanks
Special thanks to some invaluable individuals and resources while writing Hades:
- [GBATEK](https://problemkaputt.de/gbatek.htm) by Martin Korth
- [NanoBoyAdvance](https://github.com/fleroviux/NanoBoyAdvance/) by Fleroviux
- [mGBA](https://mgba.io/) and [mgba-emu/suite](https://github.com/mgba-emu/suite) by Endrift
- [gba-tests](https://github.com/jsmolka/gba-tests) by Jsmolka
- [Cowbite](https://www.cs.rit.edu/~tjh8300/CowBite/CowBiteSpec.htm) by Tom Happ
- [gdkGBA](https://github.com/gdkchan/gdkGBA/) by gdkChan
- [Tonc](https://www.coranac.com/tonc/text/toc.htm) by Cearn
- [GBA Cartridge Backup Storage](https://dillonbeliveau.com/2020/06/05/GBA-FLASH.html) by Dillon Beliveau
- [EEPROM Save Type](https://densinh.github.io/DenSinH/emulation/2021/02/01/gba-eeprom.html) by Dennis H
- [Explaining GBA Real-Time Clock (RTC)](https://beanmachine.alt.icu/post/rtc/) by Zayd
- [The Secrets of Professional Gameshark(tm) Hacking](https://gamehacking.org/faqs/hackv500c.html) by Kong K Rool and Macrox
- [Higan](https://near.sh/articles/video/color-emulation) for their color correction algorithm (by Talarubi and Near)
- [Handheld Colorspace Shaders](https://github.com/Pokefan531/Handheld-Colorspace-Shaders) for their color correction algorithms (by Pokefan531 and Hunterk)
- [The Hades Icon](https://totushi.com/) by Totushi