EMULATOR DATABASE
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.
Download Tutorials & guidesSign in to download. Files are hosted by the emulator project.

About 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.
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
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.
Screenshots

Tutorials & guides
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.
Additional information
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)
READMEs & documentation
coffee-gb official project README
# Coffee GB <p align="center"> <strong>A highly compatible Game Boy and Game Boy Color emulator for the desktop.</strong> </p> <p align="center"> <img src="doc/tetris.gif" width="326" alt="Coffee GB running Tetris DX"> </p> Coffee GB emulates the original Game Boy (GB/DMG) and Game Boy Color (GBC/CGB). It is built for high compatibility across the historic game library, unusual cartridges and accessories, and modern homebrew, demos, and diagnostic ROMs. The reusable emulation core is written in Java; the desktop application and its orchestration layer use Kotlin and Java. **[Download the latest Coffee GB release](https://github.com/trekawek/coffee-gb/releases/latest)** ## Features - **Game Boy and Game Boy Color emulation**, with Super Game Boy borders and palettes. - **High compatibility** across commercial games, unusual cartridges, homebrew, demos, and diagnostic ROMs. - **Save states and rewind**, including ten save slots, named states, previews, autosave and resume, BESS state interchange, screenshots, deterministic input recordings, and battery-backed saves. - **Easy game loading** with drag and drop and support for `.gb`, `.gbc`, and `.rom` files, either directly or from ZIP and 7z archives. - **Rollback netplay** for link-cable games, with synchronized infrared communication through CGB and HuC-1/HuC-3 cartridge hardware. - **[GBKiss Link](doc/gbkiss.md)** for sending and receiving `.gbf` files through the cartridge's infrared port. - **Customizable display and sound**, including fullscreen, scaling, rotation, grayscale, color correction, LCD ghosting, audio-device selection, and volume and latency controls. - **Keyboard and game-controller support**, including independent controls for up to four players in compatible Super Game Boy games. - **Broad cartridge and accessory support**, including real-time clocks, rumble, tilt controls, Game Boy Camera, Game Boy Printer, Barcode Boy, [Bardigun Reader](doc/bardigun.md), Full Changer, [Pocket Sonar](doc/pocket-sonar.md), [Turbo File GB/Advance](doc/turbo-file.md), [Singer/Jaguar sewing machines](doc/sewing-machines.md), and Datel Action Replay pass-through. - **Game Genie and GameShark cheats**, with a bundled searchable [libretro cheat database](https://github.com/libretro/libretro-database/tree/master/cht/Nintendo%20-%20Game%20Boy). ROM files are not included. ## Configuration On Windows, Coffee GB stores its settings in `%LOCALAPPDATA%\Coffee GB\coffeegb.properties`. If that file does not exist, settings from the earlier `%USERPROFILE%\.coffeegb.properties` location are loaded when available; subsequent changes are saved to the new location. On other platforms, the default settings file remains `~/.coffeegb.properties`. To keep the properties file beside the application, start the JAR with: ```sh java -jar coffee-gb.jar --portable ``` Portable mode uses `coffeegb.properties` in the JAR's directory and does not import the normal settings file. With an unpacked native application image it uses the launcher directory. The Windows single-file EXE extracts its launcher to a temporary directory, so use the JAR or an unpacked application image for portable settings. The application directory must be writable. This option controls the properties file; game saves and other application data keep their own locations. ## Controls Default keyboard controls: | Action | Key | | --- | --- | | D-pad | Arrow keys | | A / B | <kbd>Z</kbd> / <kbd>X</kbd> | | Start / Select | <kbd>Enter</kbd> / <kbd>Shift</kbd> | | Open menu / resume paused game | <kbd>Esc</kbd> | | Pause | <kbd>Space</kbd> | | Save / load state | <kbd>F5</kbd> / <kbd>F7</kbd> | | Take screenshot | <kbd>F12</kbd> | | Translate screen | <kbd>Ctrl/Cmd</kbd>+<kbd>T</kbd> | | Start input recording | <kbd>Ctrl/Cmd</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd> | | Rewind | Hold <kbd>Backspace</kbd> | | Toggle fullscreen | <kbd>F11</kbd> | Keyboard and game-controller bindings can be changed in **File > Preferences…**. The same window contains display, sound, and save settings. On macOS, game-controller input requires a compatible system SDL2 installation; keyboard input works without it. Use **Game > Manage States…** to choose among the ten save slots, name states, preview them, and export them. Autosave and resume settings are under **File > Preferences… > Saves & Rewind**. See [save states, autosave, screenshots, input recording, and rewind](docs/state-management.md) for more details. Pause, save states, and rewind are unavailable during netplay. Use **File > Load BESS state** and **File > Save BESS state** to exchange states with other BESS-compatible emulators. Open the matching ROM first; see the [BESS compatibility notes](docs/state-management.md#bess-state-interchange). ## Compatibility Compatibility is a defining feature of Coffee GB. Its test profiles exercise **5,858 automated verdicts from 17 suite families**, covering all popular Game Boy and Game Boy Color test suites, and every verdict passes. Coffee GB also earns the **maximum score** in [GBEmulatorShootout](https://tomek.rekawek.eu/GBEmulatorShootout/). Every exact-reference image suite is pixel-perfect: both Acid2 tests, CGB-ACID-HELL, Strikethrough, all four CasualPokePlayer tests, and all 24 Mealybug Tearoom tests. <details> <summary>Detailed compatibility results</summary> | Test suite | Cases exercised | Current result | | --- | ---: | --- | | [Blargg](https://github.com/retrio/gb-test-roms) | 54 | 54 / 54 pass\* | | [Mooneye Test Suite](https://github.com/Gekkio/mooneye-test-suite) | 130 | 130 / 130 selected cases pass | | [RTC3Test](https://github.com/aaaaaa123456789/rtc3test) | 3 | 3 / 3 menus pass | | [SameSuite](https://github.com/LIJI32/SameSuite) | 71 | 71 / 71 later-revision cases pass | | [Gambatte HWTests](https://github.com/pokemon-speedrunning/gambatte-core/tree/master/test) | 4,674 | 4,674 / 4,674 canonical DMG/CGB verdicts match hardware | | [BullyGB](https://github.com/Ashiepaws/BullyGB) | 2 | 2 / 2 DMG and CGB cases pass | | [MBC30Test](https://github.com/ZoomTen/mbc30test) | 1 | 1 / 1 ROM banking and SRAM case passes | | [GBEmulatorShootout](https://github.com/gbdev/GBEmulatorShootout/) — specific tests | 9 | Maximum score; 8 / 8 images and the ROM+RAM test pass | | [DMG-ACID2](https://github.com/mattcurrie/dmg-acid2) and [CGB-ACID2](https://github.com/mattcurrie/cgb-acid2) | 2 | 2 / 2 are pixel-perfect | | [CGB-ACID-HELL](https://github.com/mattcurrie/cgb-acid-hell) | 1 | 1 / 1 is pixel-perfect | | [Strikethrough](https://github.com/Ashiepaws/strikethrough.gb) | 1 | 1 / 1 is pixel-perfect | | [CasualPokePlayer test ROMs](https://github.com/CasualPokePlayer/test-roms) | 4 | 4 / 4 are pixel-perfect | | [Mealybug Tearoom](https://github.com/mattcurrie/mealybug-tearoom-tests) | 24 | 24 / 24 are pixel-perfect | | [GBMicrotest](https://github.com/aappleby/GBMicrotest) | 482 | 482 / 482 machine-readable verdicts pass; 31 additional diagnostics have no automated verdict | | [DocBoy Test Suite](https://github.com/Docheinstein/docboy-test-suite) | 162 | 162 / 162 selected machine-readable DMG, CGB, and CGB-in-DMG-mode verdicts pass | | [gbc-hw-tests](https://github.com/alyosha-tas/gbc-hw-tests) | 221 | 221 / 221 selected hardware-reference verdicts match exactly | | [Misc.-GB-Tests](https://github.com/alyosha-tas/Misc.-GB-Tests) | 17 | 17 / 17 pass verdicts match | | **Total** | **5,858** | **5,858 / 5,858 automated verdicts pass** | \* Blargg's aggregate and individual checks overlap by design. Every automated case must produce its documented pass value, match its selected external hardware reference, or satisfy its upstream image oracle. The source revisions, archive membership, hardware models, and ROM revisions used by these profiles are fixed for reproducibility. GBMicrotest's 31 non-verdict diagnostics are tracked separately and are not included in the 5,858 automated verdicts. </details> ## Netplay For link-cable multiplayer, open **Game > Netplay…**. One player selects **Host > Start hosting**; the other selects **Join**, enters the host's address, and selects **Join game**. Netplay uses a direct, unencrypted TCP connection, so play only with people and networks you trust. When a game is running under an SGB or SGB2 profile, starting or joining netplay restarts that game in DMG mode for the current session without changing the saved hardware-profile preference. ## Screen translation <p align="center"> <img src="doc/screen-translation.png" width="486" alt="Coffee GB translating Star Ocean: Blue Sphere"> </p> Press <kbd>Ctrl/Cmd</kbd>+<kbd>T</kbd> (or choose **View > Translate Screen**) to translate on-screen dialogue and menus directly over the game viewport. Configure your preferred provider in **File > Preferences… > Translation**: - **Google Gemini**: create a free or paid API key in [Google AI Studio](https://aistudio.google.com/apikey) and paste it into the **Google Gemini** tab. - **OpenAI**: create an API key in the [OpenAI Platform dashboard](https://platform.openai.com/api-keys) and paste it into the **OpenAI** tab. - **Ollama (Local)**: no API key is required. Install [Ollama](https://ollama.com/), pull a vision-capable model (for example `ollama pull qwen2.5vl:7b`), and keep the server URL set to `http://127.0.0.1:11434/v1` (or point it at another machine on your LAN). ## Project history Coffee GB began as a six-week deep dive into how a small computer works. The [2017 origin story](https://blog.rekawek.eu/2017/02/09/coffee-gb/) covers the CPU, pixel pipeline, audio, early compatibility testing, and first GBC implementation. The later [rollback-netplay article](https://blog.rekawek.eu/2025/07/26/rollback-netplay-gb/) explains how per-frame snapshots made high-latency link play practical. | Date | Milestone | | --- | --- | | 31 Dec 2016 | [The project starts](https://github.com/trekawek/coffee-gb/commit/f83a638c6c296adbf8020f24cea80be23f69fb10). | | 14 Jan 2017 | [The first playable version runs Tetris](https://github.com/trekawek/coffee-gb/commit/624885e1b6a390fd4ddc10ffb16d7375e2d43647), two weeks after the initial commit. | | 5–7 Feb 2017 | [Game Boy Color support](https://github.com/trekawek/coffee-gb/commit/4ca6808b79bedc6a68311ed5402d9b54456e1ffd) lands with double-speed mode, banked RAM and VRAM, color graphics, and the GBC boot path. | | 22 Dec 2017 | [Coffee GB 1.0.0](https://github.com/trekawek/coffee-gb/releases/tag/coffee-gb-1.0.0) is released. | | 29 Feb 2024 | [Save-state support](https://github.com/trekawek/coffee-gb/commit/1ec86cb4aa8d69e3289f0542ea509013b228b67d) is added. | | Jul 2025 | Fast mementos enable [rollback netplay](https://blog.rekawek.eu/2025/07/26/rollback-netplay-gb/), released in [1.5.0](https://github.com/trekawek/coffee-gb/releases/tag/coffee-gb-1.5.0). | | Aug 2025 | [Super Game Boy borders and palettes](https://github.com/trekawek/coffee-gb/releases/tag/coffee-gb-1.5.2) arrive alongside Super Game Boy command support and predefined game palettes. | ## Kudos Coffee GB owes a great deal to the Game Boy hardware research community and to the authors of every test suite linked above. Thanks to: - The authors and contributors of [SuperSnes9x](https://github.com/shanytc/snes9x) for their research, testing, and documentation of Game Boy and Game Boy Color link cable compatibility. - [Shonumi](https://shonumi.github.io/index.html) for detailed research into Game Boy hardware and peripherals in the [*Edge of Emulation* series](https://shonumi.github.io/articles.html). - [@ScottNash042](https://github.com/ScottNash042) for issue reports and feature suggestions. ## License Coffee GB is available under the [MIT License](LICENSE).Download original README
Release log
Selected releases and changes, with coverage from our weekly emulation roundup.
Sources & further reading
FROM THE COMMUNITY
Player reviews
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 coffee-gb
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
Retro Replay Retro Gaming History, Reviews & Emulation