GB
Generated by scripts/gen-format-pages.py from docs/data/format-metadata/, FILE_FORMATS.csv and docs/formats-master.csv. Do not edit by hand: change the source, then run the script.
GameBoy ROM Preview.
At a glance
| Purpose | A Game Boy or Game Boy Color cartridge ROM image. |
| Extensions | .gb |
| Poka parser | poka-gameboy-rom |
| Viewer | poka-metadata-card-viewer |
| Depth tier | Metadata card (see Depth tiers) |
| Breadth tier | B4 Summary (see Breadth tiers) |
How much Poka reads
B4 Summary. The container and metadata are read and summarised (counts, properties, structure), but the main content is not rendered.
Confidence: medium (the reviewer read the code). Basis: Reviewed 2026-10-26: read parsers/poka-gameboy-rom/src/main.rs (370 lines) and plugin.json. No unit tests or tests/samples.rs, and the corpus has no .gb, .gbc and .sgb sample. Covers .gb, .gbc and .sgb. The card decodes the cartridge header at 0x100–0x14F: title, model (DMG, CGB-compatible, CGB only), SGB support, destination, old or new licensee, version, cartridge type, ROM and RAM sizes with a size check against the file, and checks the Nintendo logo and the header checksum. Judgement: B4 rather than B5, because the whole header is decoded and checked; nothing of the ROM content (code, graphics, sound) is.
What Poka does not read
- ROM content is not decoded: no code, tiles, graphics or title screen
- The global checksum is shown but not verified
- The manufacturer code (newer cartridges) and the entry point are not shown
- New licensee codes are shown as the two raw characters, not named
- Files over 16 MiB are cut (flagged)
Libraries
Libraries Poka uses or has assessed for this format, with the status, licence and language the registry records.
- gameboy-rom (candidate; Apache-2.0; Rust; https://docs.rs/gameboy-rom) — Parses the ROM header (RomHeader, validate) and provides a streaming opcode parser; version 0.4.0.
- gb_cart (candidate; MPL-2.0 / LGPL-2.1+ / GPL-2.0+; Rust; https://lib.rs/crates/gb_cart) — Reads and writes GB/CGB header metadata; README lists three licences, exact combination not confirmed.
Sources
- parsers/poka-gameboy-rom/src/main.rs
- parsers/poka-gameboy-rom/plugin.json