Does mooneye-gb support Game Boy Color games?

No, mooneye-gb explicitly does not support Game Boy Color (CGB) as per the project's non-goals. It focuses solely on achieving extreme accuracy for the original Game Boy (DMG) first, with CGB support deferred indefinitely.

How do I run mooneye-gb on Linux?

Install Rust 1.26 and SDL2 development libraries, then use `cargo run --release` for the GUI or follow command-line instructions by placing a boot ROM in `$HOME/.local/share/mooneye-gb/bootroms/dmg_boot.bin`. Detailed steps are in the 'Running the emulator' section.

Mooneye-gb vs Gambatte: which is better for accuracy?

Mooneye-gb prioritizes documentation and test-driven accuracy, making it a better reference for developers, while Gambatte is a mature emulator with broader feature support but less explicit documentation. Mooneye-gb's test suite and technical reference give it an edge in transparency.

How to compile mooneye-gb for maximum performance?

Always compile in release mode using `cargo build --release` or `cargo run --release`, as emphasized in the README. This optimizes the Rust code to achieve speeds of 2000-4000% on modern hardware, compared to 150-200% in debug mode.

What test ROMs are included with mooneye-gb?

Mooneye-gb supports Blargg's tests and a comprehensive set of custom Mooneye acceptance tests covering CPU, PPU, timer, and MBC behavior. The test ROMs are now part of the separate Mooneye Test Suite project, linked in the README.

Is mooneye-gb good for learning emulator development?

Yes, its detailed documentation and focus on explaining hardware behavior make it an excellent learning resource. However, the Rust codebase and WIP status with known bugs might require intermediate programming skills and patience for hands-on development.

Open-Awesome

Mooneye GB

GPL-3.0Rustv0.1.0

A Game Boy research project and emulator written in Rust, focused on accuracy and clear documentation.

GitHub

966 stars60 forks0 contributors

Overview

A Game Boy research project and emulator written in Rust

Use Cases

Not Ideal For

End-users seeking a feature-complete emulator with Game Boy Color support, a built-in debugger, and a polished graphical interface.
Developers targeting Android or mobile platforms, as cross-compiling is unsupported and touch controls are not implemented.
Projects requiring immediate, bug-free compatibility with all Game Boy titles, given the emulator's WIP status and known inaccuracies in areas like sound and PPU.

Pros & Cons

Pros

Unmatched Hardware Accuracy

Focuses on precise emulation validated by an extensive suite of test ROMs, including custom Mooneye tests for CPU, PPU, timer, and memory behavior, as detailed in the acceptance tables.

Comprehensive Documentation

Documents the reasoning behind emulation decisions in the 'Game Boy: Complete Technical Reference', serving as a clear reference for developers to understand hardware behavior.

Extensive Test Coverage

Includes support for Blargg's tests and a large set of custom acceptance tests, ensuring robustness and aiding in hardware research, though some tests have known failures.

High Performance

When compiled in release mode, achieves emulation speeds of 2000-4000% on modern hardware, making it efficient for development and testing, as noted in the performance section.

Cons

Limited Feature Set

Explicitly excludes Game Boy Color support and a debugger, which are common expectations in full-featured emulators, as stated in the non-goals.

Basic User Interface

The UI is minimal and built with SDL2, lacking advanced features like save states, rewind, or customizable controls, as admitted in the README's non-goals.

Android Unsupported

While runnable on Android, cross-compiling and packaging are not supported, and touch controls are absent, limiting mobile usability, as mentioned in the performance section.

WIP with Known Issues

The project lags behind hardware research, has test failures in sound and PPU tests, and requires a boot ROM to function properly, as warned in the README.

Frequently Asked Questions

Related Projects

Ruffle

A Flash Player emulator written in Rust

Stars18,210

Forks1,037

Last commit20 hours ago

mGBA

mGBA Game Boy Advance Emulator

Stars7,110

Forks1,011

Last commit3 days ago

touchHLE

High-level emulator for iPhone OS apps. This repo is used for issues, releases and CI. Submit patches at: https://review.gerrithub.io/admin/repos/touchHLE/touchHLE

Stars3,750

Forks261

Last commit23 hours ago

SameBoy

Game Boy and Game Boy Color emulator written in C

Stars2,114

Forks254

Last commit5 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub