{
  "commit": "d38cd580364b2c788e633b9e51c15e1668f726c0",
  "count": 1,
  "generated_at": "2026-11-03T13:36:34Z",
  "items": [
    {
      "id": "sameboy",
      "profile": {
        "builtin_boot_roms": {
          "description": "Open-source boot ROM replacements compiled from BootROMs/ assembly.\nNot Nintendo originals.\n",
          "prebuilt_hashes": {
            "agb_boot.bin": {
              "md5": "7e095aa30941da3086fa0e9221335370",
              "sha1": "3b6231bdf840fb889f402d0ae89f21adb077323a"
            },
            "cgb_boot.bin": {
              "md5": "6b68be48dab6a7298a8c07e00c136b4e",
              "sha1": "9884b972110a63c9e86fb3bd241bd2e39ca82bb9"
            },
            "dmg_boot.bin": {
              "md5": "60f1d849a435e9053b8ac0fd5776804a",
              "sha1": "da853c8102acfff6b8e5a973ce0cd181f3dbb709"
            },
            "sgb2_boot.bin": {
              "md5": "b4331a9e612b4738867a30af9c96df52",
              "sha1": "576678d0fc3892b80471d7067ce6014e6af77ed5"
            },
            "sgb_boot.bin": {
              "md5": "be77bbd03f8675478f6e3d2176f3cb56",
              "sha1": "27267e45c8408857267231ba6c18bfbd052536e2"
            }
          },
          "sources": [
            "BootROMs/dmg_boot.asm -> dmg_boot (256 bytes)",
            "BootROMs/sgb_boot.asm -> sgb_boot (256 bytes)",
            "BootROMs/sgb2_boot.asm -> sgb2_boot (256 bytes)",
            "BootROMs/cgb_boot.asm -> cgb_boot (2304 bytes)",
            "BootROMs/agb_boot.asm -> agb_boot (2304 bytes)"
          ]
        },
        "core_classification": "official_port",
        "core_version": "0.15.4",
        "cores": [
          "sameboy"
        ],
        "display_name": "Nintendo - Game Boy / Color (SameBoy)",
        "emulator": "SameBoy",
        "files": [
          {
            "description": "Game Boy (DMG) boot ROM",
            "hle_fallback": true,
            "installed_on": [
              "recalbox"
            ],
            "name": "dmg_boot.bin",
            "required": false,
            "size": 256,
            "source_ref": "source libretro/libretro.c:519, source libretro/libretro.c:530, source libretro/libretro.c:556 (boot_rom_load), source Core/gb.c:1594 (request_boot_rom)",
            "system": "nintendo-gb"
          },
          {
            "description": "Super Game Boy (SGB) boot ROM",
            "hle_fallback": true,
            "installed_on": [
              "recalbox"
            ],
            "name": "sgb_boot.bin",
            "note": "Used for SGB_NTSC, SGB_PAL models. Also loaded when borrowing SGB border (Core/gb.c:264).",
            "required": false,
            "size": 256,
            "source_ref": "source libretro/libretro.c:521, source libretro/libretro.c:532, source libretro/libretro.c:556, source Core/gb.c:1600-1604",
            "system": "nintendo-sgb"
          },
          {
            "description": "Super Game Boy 2 (SGB2) boot ROM",
            "hle_fallback": true,
            "installed_on": [
              "recalbox"
            ],
            "name": "sgb2_boot.bin",
            "required": false,
            "size": 256,
            "source_ref": "source libretro/libretro.c:522, source libretro/libretro.c:533, source libretro/libretro.c:556, source Core/gb.c:1607",
            "system": "nintendo-sgb"
          },
          {
            "description": "Game Boy Color (CGB) boot ROM",
            "hle_fallback": true,
            "installed_on": [
              "recalbox"
            ],
            "name": "cgb_boot.bin",
            "note": "Used for CGB revisions A through E in the libretro port.",
            "required": false,
            "size": 2304,
            "source_ref": "source libretro/libretro.c:524, source libretro/libretro.c:535, source libretro/libretro.c:556, source Core/gb.c:1613-1618",
            "system": "nintendo-gbc"
          },
          {
            "description": "Game Boy Advance in GBC mode (AGB) boot ROM",
            "hle_fallback": true,
            "installed_on": [
              "recalbox"
            ],
            "name": "agb_boot.bin",
            "note": "Enables GBA-enhanced palettes in compatible GBC games.",
            "required": false,
            "size": 2304,
            "source_ref": "source libretro/libretro.c:525, source libretro/libretro.c:536, source libretro/libretro.c:556, source Core/gb.c:1621",
            "system": "nintendo-gbc"
          }
        ],
        "notes": "SameBoy is a high-accuracy Game Boy, Game Boy Color and Super Game Boy\nemulator by LIJI32 (official_port: same author maintains upstream and\nlibretro fork).\n\nAll boot ROMs are optional. SameBoy compiles open-source boot ROM\nreplacements from BootROMs/*.asm and embeds them into the libretro\nbinary (extern arrays dmg_boot, cgb_boot, agb_boot, sgb_boot,\nsgb2_boot in libretro/libretro.c:129-130). These are SameBoy-authored\nreplacements, not Nintendo originals.\n\nThe libretro port (boot_rom_load, libretro/libretro.c:513-589) tries to load\nan external boot ROM from the system directory first. Filename is\nconstructed as \"{model}_boot.bin\". If missing, the embedded boot ROM\nis used as fallback.\n\nBoot ROM selection depends on the sameboy_model core option\n(request_boot_rom in Core/gb.c:1587-1625):\n  DMG_B           -> GB_BOOT_ROM_DMG   -> dmg_boot.bin\n  SGB_NTSC/PAL    -> GB_BOOT_ROM_SGB   -> sgb_boot.bin\n  SGB2            -> GB_BOOT_ROM_SGB2  -> sgb2_boot.bin\n  CGB_A..E        -> GB_BOOT_ROM_CGB   -> cgb_boot.bin\n  AGB_A/GBP_A     -> GB_BOOT_ROM_AGB   -> agb_boot.bin\n\n.info declares firmware_count=2 (dmg, cgb only). Actual reachable\nfiles in the libretro port are 5 (adds sgb, sgb2, agb).\n\nUnreachable boot ROMs in the libretro port (array entries exist in\nboot_rom_load but no model option triggers them):\n  - dmg0_boot.bin: GB_MODEL_DMG_0 commented out (Core/gb.h:100)\n  - mgb_boot.bin: GB_MODEL_MGB active but not exposed by core options\n  - cgb0_boot.bin: GB_MODEL_CGB_0 active but not exposed by core options\nUpstream standalone (v1.0.3) supports these plus cgbE_boot.bin and\nagb0_boot.bin (10 boot ROM types total).\n\nNo validation performed on loaded boot ROMs. GB_load_boot_rom_from_buffer\n(Core/gb.c:266-273) does a plain memcpy capped at 0x900 bytes.\n",
        "profiled_date": "2026-03-25",
        "source": "https://github.com/libretro/SameBoy",
        "source_commit": "aa158a889a48b538a0302873704a34577c8eb67d",
        "systems": [
          "nintendo-gb",
          "nintendo-gbc",
          "nintendo-sgb"
        ],
        "type": "libretro",
        "upstream": "https://github.com/LIJI32/SameBoy",
        "upstream_commit": "9bf7e0b4dffc20941e4dfadffc6899ae19463844",
        "version_basis": {
          "kind": "file",
          "path": "version.mk",
          "pattern": "VERSION\\s+:=\\s+([0-9][\\w.+-]*)"
        }
      }
    }
  ],
  "kind": "emulators",
  "schema_version": 1
}
