v2026.04.02/emulators/boytacean.yml

emulator: Boytacean
type: standalone + libretro
core_classification: official_port
source: "https://github.com/joamag/boytacean"
upstream: "https://github.com/joamag/boytacean"
profiled_date: "2026-03-23"
core_version: "0.11.5"
display_name: "Nintendo - Game Boy / Color (Boytacean)"
cores:
  - boytacean
systems:
  - nintendo-gb
  - nintendo-gbc

notes: |
  Game Boy / Game Boy Color emulator written in Rust by Joao Magalhaes.

  Libretro: all boot ROMs compiled into binary as static byte arrays in
  src/data.rs. load_boot_static() copies from arrays. No filesystem
  access, no RETRO_ENVIRONMENT_GET_SYSTEM_DIRECTORY. No external files.
  ref: core.rs:402 instance.load(true) -> gb.rs:1311 -> load_boot_static

  Standalone (SDL): also defaults to embedded boot ROMs via load(true).
  User can override via --boot-rom-path CLI argument with any boot ROM
  file. load_boot_file() with hardcoded ./res/boot/*.bin paths exists in
  gb.rs:1361 but is not called from any frontend.

  Boot ROM defaults: DmgBootix (DMG), CgbBoytacean (CGB) — open-source.

files:
  - name: dmg_boot.bin
    system: nintendo-gb
    required: false
    hle_fallback: true
    mode: standalone
    size: 256
    note: "Original Nintendo DMG boot ROM"
    source_ref: "gb.rs:1350 load_boot_static, data.rs:14 DMG_BOOT"

  - name: sgb_boot.bin
    system: nintendo-gb
    required: false
    hle_fallback: true
    mode: standalone
    size: 256
    note: "Super Game Boy boot ROM"
    source_ref: "gb.rs:1351 load_boot_static, data.rs:29 SGB_BOOT"

  - name: dmg_bootix.bin
    system: nintendo-gb
    required: false
    hle_fallback: true
    mode: standalone
    size: 256
    note: "Open-source DMG boot ROM from Bootix (default DMG)"
    source_ref: "gb.rs:1352 load_boot_static, data.rs:44 DMG_BOOTIX"

  - name: mgb_bootix.bin
    system: nintendo-gb
    required: false
    hle_fallback: true
    mode: standalone
    size: 256
    note: "Open-source MGB (Pocket) boot ROM from Bootix"
    source_ref: "gb.rs:1353 load_boot_static, data.rs:59 MGB_BOOTIX"

  - name: cgb_boot.bin
    system: nintendo-gbc
    required: false
    hle_fallback: true
    mode: standalone
    size: 2304
    note: "Original Nintendo CGB boot ROM"
    source_ref: "gb.rs:1354 load_boot_static, data.rs:74 CGB_BOOT"

  - name: cgb_boytacean.bin
    system: nintendo-gbc
    required: false
    hle_fallback: true
    mode: standalone
    size: 2304
    note: "Custom open-source CGB boot ROM (default CGB)"
    source_ref: "gb.rs:1355 load_boot_static, data.rs:177 CGB_BOYTACEAN"