coffee-gb

GAME BOY COLOR EMULATOR

coffee-gb

Coffee GB is an open-source Game Boy / Game Boy Color emulator implemented in Java (core) and Kotlin (UI), distributed from an official GitHub repository with native-packaged releases.

Jump to download ↓Jump to setup guide ↓

coffee-gb emulator screenshot.

game boy colorPRIMARY SYSTEM

History documentedPROJECT BEGAN

Open sourcePROJECT MODEL

WHY IT MATTERS

Why consider Coffee GB

Coffee GB focuses on modern desktop polish (GUI, debugger, recent-game home screen), high compatibility for DMG/CGB titles, and cross-platform distribution via native-packaged builds. The project is actively developed on GitHub with regular releases and an issue tracker for features such as netplay, mobile adapters, and hardware-profile refinements.

BEST FOR

Best features

Cross-platform Java/Kotlin codebase; official releases that include native packaging so users may not need to manually install a JVM; a desktop UI with a recent-games home view and an integrated debugger; active development and issue discussion on compatibility and features.

The people behind coffee-gb

History and status

Coffee GB is maintained in the trekawek/coffee-gb GitHub repository. The project describes itself as a Game Boy (DMG) / Game Boy Color (CGB) emulator with Maven modules for core, UI, and controller. The repository shows an active development cadence (issues and recent releases). The project provides native-packaging documentation and a release workflow; recent release notes refer to milestone 2.0 and multiple 1.7-series releases. Ongoing issues and feature threads include netplay protocol specification, mobile adapter plans, and hardware-profile audits for AGB behavior. Because the repository contains the authoritative documentation, releases page, and issue tracker, those are the best sources for current status and downloads.

What coffee-gb supports

Game Boy (DMG)
Game Boy Color (CGB)
Desktop platforms via native packages (Windows, macOS, Linux) — see releases/docs
Debugger, GUI, controller support (per repository modules)

Download and availability

OFFICIAL DOWNLOADS

Get coffee-gb

Get official builds from the project's GitHub Releases page. The project provides native-packaged downloads (Windows MSI/portable options are documented) and traditional Java-run artifacts in releases. Consult the release assets for the platform-specific package you need.

Get coffee-gb ↗

DOCUMENTATION

Official documentation

Read the official configuration, compatibility, and troubleshooting material before changing advanced options.

Read official documentation ↗

Broken or missing download? Emulator projects move and official links sometimes change. Please contact Retro Replay so the source can be verified and updated.

coffee-gb setup guide

Setup note: Practical setup — follow the repository releases and README. The project offers native installers for some platforms so you may not need to manage a separate JVM; where native packages are not available you can run the provided JAR with a suitable Java runtime.

1) Choose the official release: Open the project's Releases page and pick the most recent stable release. Review assets for platform-specific packages (native installers or portable executables) or a JAR if provided.
2) Native package (preferred where available): If a native package is provided for your OS (for example a Windows MSI or a macOS DMG), download that asset and run the installer or mount the DMG. The project's native-packaging documentation explains how these packages are produced and what to expect (signing, runtime bundling).
3) Using the JAR (fallback): If you download a coffee-gb-*.jar, run it with the Java runtime: java -jar coffee-gb-*.jar. The repository indicates the core targets a modern Java runtime (the project documentation references Java 16 in the codebase summary), so use a recent Java LTS runtime compatible with the build. If you prefer not to install a system JVM, use a native package when present.
4) First launch and configuration: On first run, grant any OS-level permissions requested by the native package. Use the home screen to add ROM folders or open a ROM via the UI. Configure controller input in the controller/settings panel and set display / audio preferences to taste.
5) Save states, debugger and advanced tools: Coffee GB includes save-state capabilities and an integrated debugger in recent releases. Use the UI command bar or menus to access save-state slots, rewind features (noted in release notes), and the debugger when debugging or developing homebrew. Refer to the release notes or repository docs for the exact keyboard shortcuts and debugger usage.
6) Keep the emulator up to date: Watch the GitHub repository or releases page for updates. The project uses GitHub releases and has an active issue tracker; reading recent changelogs will clarify compatibility fixes or new packaging changes.

Software reminder: Commercial games, firmware, and BIOS are not included — you must provide your own legally obtained ROM files. Follow local laws and the project's license for use and distribution.