Pyrite

GBA emulator in Rust.

Build

For target specific instructions:

• Windows
• MacOS
• Linux

cargo build             # This will build with optimizations but will keep debug information
                        # and debug assertions.

cargo build --release   # This will build with all optimizations and will strip debug information
                        # and disable debug assertions.

cargo build --profile=profiling # This will build will full optimizations and debug information
                                # but will disable debug assertions.

Run

cargo run -- --help     # To see all options available.
cargo run -- <ROM>      # To run with the specified GBA ROM file.

Key Bindings

• Ctrl+D: Open the debugger.
• Ctrl+P: Pause or unpause the emulator.
• Ctrl+R: Reset the GBA.

See build section for more information on profiles (debug, release, profiling).

Linux

The debugger uses egui and egui_glow for rendering which has a few requirements.

For Debian and its derivatives:

sudo apt-get install libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libspeechd-dev libxkbcommon-dev libssl-dev

Windows

Instructions in Build and Run sections should just work. If not please file an issue.

MacOS

Instructions in Build and Run sections should just work. If not please file an issue.