
   ____                 _                  
  / ___| ___  __ _ _ __| |__   ___  _   _  
 | |  _ / _ \/ _` | '__| '_ \ / _ \| | | | 
 | |_| |  __/ (_| | |  | |_) | (_) | |_| | 
  \____|\___|\__,_|_|  |_.__/ \___/ \__, | 
                                    |___/  

-----------------------------------------------------
Instructions and tips at:
https://github.com/drhelius/Gearboy
-----------------------------------------------------
Gearboy is an accurate cross-platform Game Boy / Game Boy Color emulator written in C++ that runs on Windows, macOS, Linux, BSD and RetroArch, with an embedded MCP server for debugging and tooling.
Please, consider sponsoring (https://github.com/sponsors/drhelius) and following me on Twitter (http://twitter.com/drhelius) for updates.
-----------------------------------------------------
Features:
    - Supported cartridges: ROM, ROM + RAM, MBC1, MBC2, MBC3, MBC5, MBC7, HuC-1, HuC-3, MMM01, Pocket Camera, TAMA5 and MBC1M (multicart).
    - Accurate LCD controller emulation with correct timings and priorities including mid-scanline effects.
    - Game Boy Color support.
    - LCD screen ghosting effect as seen in the original Game Boy.
    - LCD dot matrix effect.
    - Battery powered RAM save support.
    - Save states.
    - Compressed rom support (ZIP).
    - Bootrom (BIOS) support.
    - Game Genie and GameShark cheat support.
    - VGM recorder.
    - Supported platforms (standalone): Windows, Linux, BSD and macOS.
    - Supported platforms (libretro): Windows, Linux, macOS, Raspberry Pi, Android, iOS, tvOS, PlayStation Vita, PlayStation 3, Nintendo 3DS, Nintendo GameCube, Nintendo Wii, Nintendo WiiU, Nintendo Switch, Emscripten, Classic Mini systems (NES, SNES, C64, ...), OpenDingux, RetroFW and QNX.
    - Full debugger with just-in-time disassembler, CPU breakpoints, memory access breakpoints, code navigation (goto address, JP JR and CALL double clicking), debug symbols, automatic labels, memory editor, trace logger, IO inspector and VRAM viewer including tiles, sprites, backgrounds and palettes.
    - MCP server for AI-assisted debugging with GitHub Copilot, Claude, Codex and similar, exposing tools for execution control, memory inspection, hardware status, and more.
    - Windows and Linux Portable Mode.
    - ROM loading from the command line by adding the ROM path as an argument.
    - ROM loading using drag & drop.
    - Support for modern game controllers through gamecontrollerdb.txt file located in the same directory as the application binary.
-----------------------------------------------------
Gearboy is licensed under the GNU General Public License v3.0 License:

Copyright (C) 2012 Ignacio Sanchez
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/
