Online Nintendo Game Boy (DMG-01) & Game Boy Color (GBC) Browser Emulator — Play .GB & .GBC (Gambatte Wasm)

100% client-side Sharp LR35902 cycle-accurate browser emulator powered by GPL Gambatte WebAssembly — with DMG-01 Olive / Pocket / Light LCD palette switcher, MBC1/MBC3/MBC5 battery save persistence, and IndexedDB states

GPL-2.0-or-later Open-Source Core Gambatte (Libretro GB/GBC Wasm) 1989 / 1998 · 8-Bit Handheld 100% Client-Side (IndexedDB)

Nintendo Game Boy / Game Boy Color Browser Emulator Workbench

CPU: Sharp LR35902 @ 4.194 MHz (DMG) / 8.388 MHz Double-Speed (CGB) • Video: 160×144 Dot-Matrix LCD (4 Olive Shades on DMG-01 · 32,768 Colours on CGB) • Audio: 4-Channel Stereo APU (2 Square/Sweep · 1 Programmable Wave · 1 Noise)

Game Boy / GBC (DMG / CGB) Emulator — .GB, .GBC, .DMG, .ZIP

Run Nintendo Game Boy (.GB) and Game Boy Color (.GBC) homebrew and user-supplied ROMs 100% locally in your browser using the cycle-accurate GPL Gambatte WebAssembly core. Includes DMG-01 olive green LCD palette toggle and IndexedDB saves. Need capacitor BOMs, voltage rail checks, or DIP/PLCC pinouts? Visit the Nintendo Game Boy & Game Boy Color Hub.

WASM + CLIENT FS READY (14 GPL CORES)
🤖 AI 6502 Guide ↓
Drop Any Disk, Tape, Cartridge, Snapshot, or .ZIP File Here — or Click to Browse
100% Client-Side Execution (Zero Server Uploads) • Automatically Detects System & Boots Locally
Game Boy / GBC (DMG / CGB) Supported Formats: .gb .gbc .dmg .zip
⚡ Instant Demo Test Payload READY (Game Boy / GBC (DMG / CGB))

Don't have a disk or ROM file handy? Boot our clean-room diagnostic test payload for the active machine with 1 click:

NINTENDO GAME BOY DMG-01 OLIVE DOT-MATRIX / CGB COLOR LCD
CPU: Sharp LR35902 @ 4.194 MHz (DMG) / 8.388 MHz Double-Speed (CGB) • 160×144 Dot-Matrix LCD (4 Olive Shades on DMG-01 · 32,768 Colours on CGB) • 50.0 FPS
⌨ Click screen to focus keyboard • Type commands directly or use System Quick-Boot Macros below
DRV / SLOT: READY (LOCAL FS)
⚡ Game Boy / GBC (DMG / CGB) Quick-Boot Macros & Hardware Shortcuts Core: Gambatte (Libretro GB/GBC Wasm)

Commodore 8-Bit Controls (C64 / C128 / VIC-20 / Plus/4)

VICE Wasm · IEC #8 · DB9
1541/1571/1581 Multi-Disk Carousel (Drive 8)

Commodore Amiga Controls (A500 / A600 / A1200)

PUAE Wasm · OCS/ECS/AGA
Kickstart Hash Matrix →

BBC Micro & Dragon 32/64 Controls

jsbeeb & XRoar (GPL-3.0)

Amstrad CPC Controls (464 / 664 / 6128 / Plus)

μPD765A · CTM644 / GT65
3″ Floppy Disk Drives (Drive A & Drive B)
DRIVE A (|A): SMIGGY-CPC.DSK (40T)
DRIVE B (|B): BONUS-SIDE-B.DSK (40T)
One-Click Locomotive BASIC Quick-Boot Macros

ZX Spectrum Controls (48K / 128K)

Fuse Wasm · ULA $FE / $7FFD

Atari 8-Bit / ST, MSX & 8-Bit Console Deck

Atari800 · Hatari · blueMSX · FCEUmm · Gambatte

Save States & Client-Side BIOS/ROM Manager

100% Local IndexedDB
Machine Snapshot States (IndexedDB + .state)
No state saved in Slot 1 yet — click Save State to persist in browser IndexedDB.
🔒 Client-Side BIOS / Kickstart / TOS ROM Dropzone Zero BIOS Required (Optional dmg_boot.bin / cgb_boot.bin)

Zero Server Hosting Policy: Gambatte boots all .GB and .GBC cartridges directly without requiring a boot ROM. You may optionally upload dmg_boot.bin (256B) or cgb_boot.bin (2KB) to IndexedDB if you wish to see the power-on scroll animation.

Verify ROM CRC32 in BIN Patcher →

⌨ Interactive Keyboard Mapping Diagram & Virtual Key Matrix

Showing PC Keyboard Mappings for Nintendo Game Boy / Game Boy Color — click any virtual key below to trigger it directly in the emulator.

Virtual Joystick / D-Pad & Console Pad
SYSTEM WORKBENCH FAQ · GAME BOY / GBC (DMG / CGB)

Nintendo Game Boy / Game Boy Color Browser Emulation & Hardware Bench Reference

Common questions when running Nintendo Game Boy / Game Boy Color (.gb, .gbc, .dmg, .zip) images in the browser via Gambatte (Libretro GB/GBC Wasm), or testing homebrew builds alongside our Nintendo Game Boy & Game Boy Color Hub.

Can I switch between the classic 1989 DMG-01 green screen and Game Boy Pocket greyscale?

Yes! Use the LCD Palette buttons in the Game Boy Controls deck to switch between 1989 DMG-01 Olive Green, 1996 Game Boy Pocket Greyscale, 1998 Game Boy Light Teal Backlight, and full 15-bit Game Boy Color palettes.

Where can I find capacitor recap lists, IC pinouts & fault flowcharts for Game Boy / GBC (DMG / CGB)?

Open the dedicated Nintendo Game Boy & Game Boy Color Hub (/gameboy) → for board-level electrolytic capacitor replacement tables, power-supply polarity alerts, oscilloscope waveforms, and DIP/PLCC pinout diagrams for Sharp LR35902 @ 4.194 MHz (DMG) / 8.388 MHz Double-Speed (CGB) and 160×144 Dot-Matrix LCD (4 Olive Shades on DMG-01 · 32,768 Colours on CGB).

TECHNICAL COMPANION GUIDE · REVERSE ENGINEERING & MODERNIZATION

AI-Assisted C64 Disassembly & Modernization: From 6502 Binary to C, JS & WebAssembly

How classic 8-bit Commodore 64 (MOS 6510) and Commodore 128 (MOS 8502) binaries are reverse-engineered using Claude Code and Model Context Protocol (MCP) bridges (Ghidra, Regenerator2000, and headless VICE), translated from cycle-counted 6502 assembly and VIC-II raster logic into portable C/JavaScript/WebAssembly, and paired with upscaled 24×21 hardware sprites and MOS 6581/8580 SID audio for modern remakes.

1. Reverse-Engineering 6502 Binaries with Claude Code & MCP Bridges

Disassembling a raw 1980s Commodore 64 .PRG or .D64 image is notoriously challenging because 6502 machine code intermingles executable instructions, inline data tables, self-modifying operand bytes, and $0001 PLA bank-switching. Before loading a disk image into the emulator above, you can inspect its physical sector chains and extract individual .PRG binaries using our Rust/Wasm .D64 Disk Visualizer & BAM Parser.

By connecting Claude Code to three specialized reverse-engineering tools via Model Context Protocol (MCP) servers, an AI agent can iteratively explore, label, and verify a 64KB memory snapshot in real time:

A. Ghidra MCP Bridge (Control-Flow & Decompilation)

An MCP bridge to a headless or GUI Ghidra project exposes tool calls such as get_function_at(addr), rename_symbol(addr, name), set_data_type(addr, len), and get_xrefs_to(addr). Claude Code queries cross-references to hardware registers ($D000–$D02E VIC-II, $D400–$D418 SID, $DC00 CIA #1 Joystick) and automatically propagates semantic symbol names (e.g. renaming sub_09A4 to update_player_sprite_collision) across the entire call graph.

B. Regenerator2000 MCP Bridge (Interactive 6502 Disassembly)

Regenerator2000 excels at separating 6502 code from inline lookup tables (low/high byte split jump tables, PETSCII strings, and screen matrix pointers). Through an MCP bridge, Claude Code inspects undecoded regions, identifies paired LDA tbl_lo,X : STA $FB / LDA tbl_hi,X : STA $FC zero-page pointers, marks byte/word/petscii data blocks, and exports clean, re-assemblable 6502 source compatible with our In-Browser 6502/Z80 Cross-Assembler.

C. Headless VICE Monitor MCP Bridge (Dynamic Runtime Tracing)

Static analysis alone cannot resolve runtime decrunchers (Exomizer, PuCrunch) or self-modifying speedcode. By bridging Claude Code to VICE's binary monitor port (-binarymonitor / -remotemonitor) in headless mode, the agent sets execution breakpoints after decompression, dumps live 64KB RAM after the game loop initializes, profiles exact scanline timing on $D012, and verifies hypotheses by injecting joystick inputs and asserting zero-page state changes.

2. Translating 6502 Assembly & VIC-II Hardware Logic to Modern C, JS & WebAssembly

Once every subroutine, zero-page variable ($02–$FF), and hardware interrupt vector ($0314/$0315 or $FFFE/$FFFF) is documented, translating a 6502 game engine into idiomatic C, TypeScript/JavaScript, or Rust/WebAssembly follows four structural transformations. You can verify individual instruction flag behaviors and cycle counts during translation with our MOS 6502/6510 Opcode Lookup & Cycle Counter:

  • Zero-Page Variables → Typed State Struct: Replace raw zero-page addresses (e.g. $62 player X LSB, $63 player X MSB, $64 player Y, $65 lives) with an explicit GameState struct in C/Rust or a typed JS state object.
  • Raster IRQ Chains ($D012) → Frame-Phase State Machine: Classic C64 games multiplex sprites and split scrolling regions by chaining raster interrupts at scanlines (e.g. $D012 = $32 top HUD, $D012 = $78 playfield, $D012 = $FA bottom border). In a modern C/WASM or Canvas remake, lift each raster ISR into a deterministic per-frame update stage and render pass.
  • 6502 Decimal Mode (SED / ADC) → BCD or Integer Score Helpers: Remember that 6502 games almost universally store 6-digit high scores as packed Binary-Coded Decimal (BCD) bytes updated under SED (Set Decimal Flag) so each nybble maps directly to screen codes $30–$39.
  • Self-Modifying Code → Parameterized Pointers / Array Indexing: Where 6502 code patches the immediate or absolute address of an LDA $1000,X instruction in place to save zero-page indirect-indexed cycles (5 cycles vs. 4 cycles), replace the self-modification with a clean array slice or pointer offset.
Original Disassembled 6510 Routine (VIC-II 9-Bit Sprite X + Raster Sync)
; Update Player Sprite 0 X/Y (9-bit X across $D000 + $D010 bit 0)
update_player_vic:
    LDA zp_plr_x_lo     ; $62: Player X low byte (0..255)
    STA $D000           ; VIC-II Sprite 0 X-coord LSB
    LDA $D010           ; VIC-II Sprites 0..7 X-coord MSB
    AND #$FE            ; Clear bit 0 (Sprite 0 MSB)
    LDX zp_plr_x_hi     ; $63: Is X >= 256?
    BEQ no_msb_set
    ORA #$01            ; Set Sprite 0 X MSB ($D010 bit 0)
no_msb_set:
    STA $D010
    LDA zp_plr_y        ; $64: Player Y (0..255)
    STA $D001           ; VIC-II Sprite 0 Y-coord
    RTS
Modernized C / WebAssembly Equivalent (Clean Struct + Hardware Abstraction)
typedef struct {
    uint16_t player_x;   // Unified 9-bit X coordinate (0..511)
    uint8_t  player_y;   // Y coordinate (0..255)
    uint8_t  d010_msb;   // Shadow register for $D010
} GameState;

void update_player_vic(GameState *st, uint8_t *vic_regs) {
    vic_regs[0x00] = (uint8_t)(st->player_x & 0xFF);
    if (st->player_x >= 256) {
        st->d010_msb |= 0x01;
    } else {
        st->d010_msb &= ~0x01;
    }
    vic_regs[0x10] = st->d010_msb;
    vic_regs[0x01] = st->player_y;
}

3. Extracting & Upscaling 24×21 VIC-II Sprites and SID Audio for Modern Remakes

A faithful modern port or hybrid Wasm remake preserves the exact visual and sonic identity of the original C64 release while offering optional HD enhancements:

1. Extracting 64-Byte (24×21) VIC-II Sprite Banks

Every VIC-II hardware sprite occupies 63 bytes of pixel data (21 rows × 3 bytes/row = 24×21 pixels) plus 1 padding byte (64 bytes per block), addressed via the 8 sprite pointers at the end of Screen RAM ($07F8–$07FF in default Bank 0, where addr = ptr * 64). In Monochrome Mode, each bit is 1 pixel (24×21). In Multicolor Mode ($D01C bit set), horizontal pixels are paired into 12×21 2-bit bitpairs: 00 = transparent, 01 = shared Multicolor 0 ($D025), 10 = individual sprite colour ($D027–$D02E), and 11 = shared Multicolor 1 ($D026).

Workflow Tip: Pipe extracted 64-byte sprite blocks into our Interactive 24×21 Sprite & 8×8 Tile Converter to edit frames with the Colodore palette and export C uint8_t arrays, 6502 .byte tables, or integer-upscaled / CRT-filtered sprite sheets. For full-screen .KOA or .ART title screens, use the Retro Graphics Viewer & PNG Converter.

2. Ripping & Modernizing MOS 6581 / 8580 SID Audio

C64 game music drivers typically consist of an INIT entry point (which selects the subtune in the Accumulator) and a 50Hz PAL / 60Hz NTSC raster PLAY routine that updates the 25 write-only SID registers at $D400–$D418 once per frame. By wrapping the isolated music code and data tables with a 124-byte PSID v2 header, you can play, solo/mute individual voices, inspect live pulse-width/filter sweeps, and export 16-bit .WAV stems directly in our Commodore 64 .SID File Player & Header Editor, or recreate patches interactively in the 3-Voice WebAudio SID Chiptune Synthesizer.

4. Complete 14-System Browser Emulator Spoke & Hardware Repair Hub Matrix

Every emulator spoke page under /bench-tools/retro-emulator/<system-slug> is paired directly with its corresponding board-level hardware repair, capacitor recap, and IC pinout hub:

Comments (0)

No comments yet. Be the first to share your thoughts on this tool!

Leave a Comment

Theme Palette

Default Dark
High-contrast dark
Amber Terminal
Monochrome amber
Matrix CRT
Phosphor green
Workbench Light
Clean light mode

Audio & Display

Relay Click Sounds Web Audio API — soft mechanical clicks
CRT Scanline & Flicker Pure CSS overlay effect

System Info

Customization Panel Theme preference, audio FX, and CRT overlay settings are saved to your browser's localStorage and persist between visits. No cookies or server-side storage is used.
Keyboard Shortcuts Press Esc to close this panel. Use the header moon/sun icon to cycle themes.