2026-03-25 14:50:09 +01:00
# RetroBIOS
2026-03-17 10:54:39 +01:00
feat: standalone emulator support for batocera and multi-platform name mapping
resolve_platform_cores() builds reverse index from profile cores: field,
fixing 17 name mismatches across Batocera, RetroBat, and Recalbox
(genesisplusgx, pce_fast, pcfx, vb, mame078plus, vice cores, etc.).
standalone_path field on file entries + standalone_cores on platform
YAMLs enable mode-aware pack generation. find_undeclared_files() uses
standalone_path for cores the platform runs standalone, filters by
mode: libretro/standalone per file.
batocera.yml gains standalone_cores (92 entries from configgen-defaults).
generate_readme.py dynamically lists platforms from registry.
3 profiles updated for standalone type/path (mame, hatari, mupen64plus_next).
78 E2E tests pass, pipeline verified.
2026-03-26 00:44:21 +01:00
Complete BIOS and firmware packs for Batocera, EmuDeck, Lakka, Recalbox, RetroArch, RetroBat, RetroDECK, RetroPie, and RomM.
2026-03-17 10:54:39 +01:00
feat: add 12 batocera standalone profiles, update 3 existing
New profiles: citron (Switch), clk (multi-system), demul (Hikaru),
eka2l1 (Symbian/N-Gage), gsplus (Apple IIGS), lexaloffle (PICO-8),
openmsx (MSX), ryujinx (Switch), shadps4 (PS4), tsugaru (FM Towns),
x16emu (Commander X16), xroar (Dragon/CoCo), zc210 (Zelda Classic).
Updated: amiberry, fsuae (standalone Amiga), ymir (Saturn standalone).
2026-03-26 07:01:16 +01:00
**6,748** verified files across **322** systems, ready to extract into your emulator's BIOS directory.
2026-03-25 14:50:09 +01:00
2026-03-25 17:17:38 +01:00
## Download BIOS packs
2026-03-25 14:50:09 +01:00
2026-03-25 17:17:38 +01:00
Pick your platform, download the ZIP, extract to the BIOS path.
2026-03-25 14:50:09 +01:00
2026-03-25 17:17:38 +01:00
| Platform | BIOS files | Extract to | Download |
|----------|-----------|-----------|----------|
| Batocera | 359 | `/userdata/bios/` | [Download ](../../releases/latest ) |
| EmuDeck | 161 | `Emulation/bios/` | [Download ](../../releases/latest ) |
| Lakka | 448 | `system/` | [Download ](../../releases/latest ) |
| Recalbox | 346 | `/recalbox/share/bios/` | [Download ](../../releases/latest ) |
| RetroArch | 448 | `system/` | [Download ](../../releases/latest ) |
| RetroBat | 331 | `bios/` | [Download ](../../releases/latest ) |
| RetroDECK | 2007 | `~/retrodeck/bios/` | [Download ](../../releases/latest ) |
| RetroPie | 448 | `BIOS/` | [Download ](../../releases/latest ) |
2026-03-25 23:00:11 +01:00
| RomM | 374 | `bios/{platform_slug}/` | [Download ](../../releases/latest ) |
2026-03-25 14:50:09 +01:00
2026-03-25 17:17:38 +01:00
## What's included
2026-03-17 10:54:39 +01:00
2026-03-25 17:17:38 +01:00
BIOS, firmware, and system files for consoles from Atari to PlayStation 3.
Each file is checked against the emulator's source code to match what the code actually loads at runtime.
2026-03-17 10:54:39 +01:00
2026-03-25 23:00:11 +01:00
- **9 platforms** supported with platform-specific verification
feat: add 12 batocera standalone profiles, update 3 existing
New profiles: citron (Switch), clk (multi-system), demul (Hikaru),
eka2l1 (Symbian/N-Gage), gsplus (Apple IIGS), lexaloffle (PICO-8),
openmsx (MSX), ryujinx (Switch), shadps4 (PS4), tsugaru (FM Towns),
x16emu (Commander X16), xroar (Dragon/CoCo), zc210 (Zelda Classic).
Updated: amiberry, fsuae (standalone Amiga), ymir (Saturn standalone).
2026-03-26 07:01:16 +01:00
- **319 emulators** profiled from source (RetroArch cores + standalone)
- **322 systems** covered (NES, SNES, PlayStation, Saturn, Dreamcast, ...)
2026-03-25 23:00:11 +01:00
- **6,748 files** verified with MD5, SHA1, CRC32 checksums
- **5251 MB** total collection size
2026-03-25 17:17:38 +01:00
## Supported systems
feat: add 12 batocera standalone profiles, update 3 existing
New profiles: citron (Switch), clk (multi-system), demul (Hikaru),
eka2l1 (Symbian/N-Gage), gsplus (Apple IIGS), lexaloffle (PICO-8),
openmsx (MSX), ryujinx (Switch), shadps4 (PS4), tsugaru (FM Towns),
x16emu (Commander X16), xroar (Dragon/CoCo), zc210 (Zelda Classic).
Updated: amiberry, fsuae (standalone Amiga), ymir (Saturn standalone).
2026-03-26 07:01:16 +01:00
NES, SNES, Nintendo 64, GameCube, Wii, Game Boy, Game Boy Advance, Nintendo DS, Nintendo 3DS, Switch, PlayStation, PlayStation 2, PlayStation 3, PSP, PS Vita, Mega Drive, Saturn, Dreamcast, Game Gear, Master System, Neo Geo, Atari 2600, Atari 7800, Atari Lynx, Atari ST, MSX, PC Engine, TurboGrafx-16, ColecoVision, Intellivision, Commodore 64, Amiga, ZX Spectrum, Arcade (MAME), and 288+ more.
2026-03-25 17:17:38 +01:00
Full list with per-file details: ** [https://abdess.github.io/retrobios/ ](https://abdess.github.io/retrobios/ )**
2026-03-17 10:54:39 +01:00
2026-03-18 10:44:13 +01:00
## Coverage
2026-03-17 10:54:39 +01:00
2026-03-18 10:44:13 +01:00
| Platform | Coverage | Verified | Untested | Missing |
|----------|----------|----------|----------|---------|
2026-03-20 19:12:35 +00:00
| Batocera | 359/359 (100.0%) | 358 | 1 | 0 |
2026-03-19 15:15:53 +00:00
| EmuDeck | 161/161 (100.0%) | 161 | 0 | 0 |
2026-03-25 23:00:11 +01:00
| Lakka | 448/448 (100.0%) | 448 | 0 | 0 |
| Recalbox | 346/346 (100.0%) | 346 | 0 | 0 |
| RetroArch | 448/448 (100.0%) | 448 | 0 | 0 |
| RetroBat | 331/331 (100.0%) | 331 | 0 | 0 |
| RetroDECK | 2007/2007 (100.0%) | 2007 | 0 | 0 |
| RetroPie | 448/448 (100.0%) | 448 | 0 | 0 |
| RomM | 374/374 (100.0%) | 359 | 15 | 0 |
2026-03-17 10:54:39 +01:00
2026-03-26 07:15:01 +01:00
## Build your own pack
Clone the repo and generate packs for any platform, emulator, or system:
```bash
# Full platform pack
python scripts/generate_pack.py --platform retroarch --output-dir dist/
python scripts/generate_pack.py --platform batocera --output-dir dist/
# Single emulator or system
python scripts/generate_pack.py --emulator dolphin
python scripts/generate_pack.py --system sony-playstation-2
# List available emulators and systems
python scripts/generate_pack.py --list-emulators
python scripts/generate_pack.py --list-systems
# Verify your BIOS collection
python scripts/verify.py --all
python scripts/verify.py --platform batocera
python scripts/verify.py --emulator flycast
```
Only dependency: Python 3 + `pyyaml` .
## Documentation site
The [documentation site ](https://abdess.github.io/retrobios/ ) provides:
- **Per-platform pages** with file-by-file verification status and hashes
- **Per-emulator profiles** with source code references for every file
- **Per-system pages** showing which emulators and platforms cover each console
- **Gap analysis** identifying missing files and undeclared core requirements
- **Cross-reference** mapping files across 9 platforms and 319 emulators
2026-03-25 17:17:38 +01:00
## How it works
Documentation and metadata can drift from what emulators actually load.
To keep packs accurate, each file is checked against the emulator's source code.
1. **Read emulator source code** - trace every file the code loads, its expected hash and size
2. **Cross-reference with platforms** - match against what each platform declares
3. **Build packs** - include baseline files plus what each platform's cores need
4. **Verify** - run platform-native checks and emulator-level validation
2026-03-19 23:26:43 +01:00
## Contributors
2026-03-25 23:00:11 +01:00
< a href = "https://github.com/PixNyb" > < img src = "https://avatars.githubusercontent.com/u/40770831?v=4" width = "50" title = "PixNyb" > < / a >
2026-03-19 23:26:43 +01:00
< a href = "https://github.com/monster-penguin" > < img src = "https://avatars.githubusercontent.com/u/266009589?v=4" width = "50" title = "monster-penguin" > < / a >
2026-03-17 10:54:39 +01:00
## Contributing
2026-03-18 10:44:13 +01:00
See [CONTRIBUTING.md ](CONTRIBUTING.md ) for guidelines.
2026-03-17 10:54:39 +01:00
## License
This repository provides BIOS files for personal backup and archival purposes.
2026-03-26 07:15:01 +01:00
*Auto-generated on 2026-03-26T06:14:11Z*