poka.sh

Docs

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