Skip to content
Hades

Hades

EMULATOR DATABASE

Hades

Hades is an open-source Game Boy Advance (GBA) emulator that aims for a balance of usability, speed and accuracy. It provides controller support, save states, shader effects, limited GPIO device emulation (RTC, rumble), and the ability to load games from common archive formats.

6.0 / 10

game boy advance

Download Tutorials & guides

Sign in to download. Files are hosted by the emulator project.

Game Boy Advance
SYSTEM SPOTLIGHTGame Boy AdvanceArtwork from the Retro Replay system database

About Hades

Hades targets a mix of accuracy and modern usability: it includes save states, controller remapping, shader options (color correction, xBRZ, LCD effects), and can load ROMs from archives. The project is actively developed on GitHub and includes build instructions and Linux/AppImage/desktop releases.

Users who want an actively developed, source-driven GBA emulator with modern front-end features (shaders, save states, controller remapping) and those who prefer building from source or using official binaries distributed by the project.

The people behind Hades / history

Hades is maintained as an open-source project on GitHub (repository hades-emu/Hades). The repo shows an active commit history and official releases distributed through GitHub Releases. The project describes itself as under heavy development and credits accuracy resources such as GBATEK, mGBA, and other GBA research/emulators. The developers provide build instructions (Meson/Ninja) and list required dependencies. Project activity, releases, and the source tree are hosted on GitHub and the project runs cross-platform builds and prebuilt releases per the project's download page.

Screenshots

Game screenshot from a game boy advance title
Game screenshot from the game boy advance library. Image from Retro Replay media.

Tutorials & guides

Hades setup guide (click to expand)

Setup note: This setup guide covers obtaining an official build (or building from source), preparing a GBA BIOS if you choose to use one, and running games. Follow only official project downloads and your own legally-owned firmware/ROMs.

  1. 1) Choose download or build: Check the project's GitHub Releases for prebuilt binaries for your platform. If a prebuilt binary is not available for your OS or you prefer to compile, clone the official repository and follow the build steps.
  2. 2) Prepare build dependencies (if building): Hades uses Meson and Ninja. Typical dependencies listed in the repository include: meson, ninja, GCC/clang, SDL3 development headers, OpenGL, GLEW, and libarchive. On Debian/Ubuntu this is commonly installed via apt; on Fedora use dnf. After installing dependencies, initialize submodules, configure with meson, then run ninja to compile.
  3. 3) Download official binary (alternative to building): Download the platform-appropriate release artifact from the GitHub Releases page. For Linux, the project may provide an AppImage or tarball; for Windows a zip or installer; for macOS a dmg or zip. Verify checksums if provided.
  4. 4) BIOS / firmware note: Hades' user documentation refers to opening a BIOS file (commonly named bios.bin) from the File menu before loading a ROM. The official project does not include any proprietary BIOS/firmware — you must supply your own legally-obtained BIOS if you choose to use one. Some emulators can run certain games without a BIOS, but follow the project's instructions on the exact behavior for Hades.
  5. 5) Running your first game: Start Hades, use File → Open BIOS to load a bios.bin if you have one (per the project's docs), then File → Open to select a .gba file (or an archive containing .gba). The emulator supports loading from .zip/.7z/.rar archives.
  6. 6) Configure controls and performance: Open the input settings to map keyboard and gamepad buttons. Enable or adjust shaders (color correction, xBRZ, LCD effects) in the graphics/settings panel. Use save states/quick saves for snapshots. If you need improved performance, consult the build options and runtime settings; JIT or CPU-specific optimizations are mentioned in the repo notes for some platforms.
  7. 7) Troubleshooting and reporting issues: If you encounter problems, consult the project's README and official website for known issues and platform-specific instructions. Report reproducible bugs on the project's GitHub Issues tracker and include platform, build/release version, and log output where possible.

Software reminder: Hades does not bundle commercial games, firmware, BIOS files, or proprietary ROMs. Use only content you legally own and supply any required BIOS yourself.

Additional information

What Hades supports

  • Game Boy Advance (GBA) cartridge images (.gba)
  • Windows (official release binaries available)
  • Linux (AppImage / desktop builds and source build supported)
  • macOS (official releases / source build supported)
  • Controller input (gamepads), keyboard mapping
  • Save states (quick save/load), shader effects, basic RTC and rumble support

READMEs & documentation

Hades official project README
# 🔥 Hades

![license](https://img.shields.io/github/license/hades-emu/hades)
[![Build](https://github.com/hades-emu/hades/actions/workflows/build.yml/badge.svg)](https://github.com/hades-emu/hades/actions/workflows/build.yml)
[![Discord](https://img.shields.io/discord/1380316885979234424?label=discord&logo=discord&color=%235865F2)](https://discord.com/invite/zBHkV836AK)

<p align="center"><a href="https://hades-emu.org/"><img src="https://i.imgur.com/4OrVpX2.png"></a></p>
<p align="center"><i>A Nintendo Game Boy Advance Emulator</i></p>

## Screenshots

<p align="center">
  <img src="https://i.imgur.com/29JPzmU.png">
  <img src="https://i.imgur.com/kyEfEam.png">
  <img src="https://i.imgur.com/c84TjGW.png">
</p>
<p align="center">
  <img src="https://i.imgur.com/WGCHWJv.png">
  <img src="https://i.imgur.com/0LMmkRD.png">
  <img src="https://i.imgur.com/pbdR5AN.png">
</p>

## 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
Download original README

Original project README source

Release log

Selected releases and changes, with coverage from our weekly emulation roundup.

    Sources & further reading

    FROM THE COMMUNITY

    Player reviews

    0 reviews
    6.0/ 10

    Overall rating

    Provisional site rating and approved member scores, each counted once.

    Starting site scores are provisional editorial scores. Established mainstream projects receive a higher starting score; other imported entries begin at a neutral 6/10 pending individual review. Member scores change the average after approval.

    Your take on Hades

    Spam has been overwhelming. To help us approve your review, sign up and introduce yourself in the Introductions forum so we know you’re not a bot.

    Sign in with your Retro Replay account to rate this project and share your experience.

    Sign in to review