Add emulator profiles and update docs

Add new emulator profiles (ares, BigPEmu, Eden, Model2, PrimeHack, Supermodel, Suyu, Xenia Canary, Yuzu) under emulators/*.yml with metadata, notes, file lists and exclusion/hle details. Update README counts (emulators/systems/files summary and auto-generated timestamp) and bump generated_at in database.json. Adjust mkdocs.yml navigation counts and add Yuzu entry to the Emulators nav.
This commit is contained in:
Abdessamad Derraz
2026-03-26 13:22:11 +01:00
parent 0a1880f606
commit 74f48b8881
12 changed files with 1095 additions and 11 deletions

441
emulators/ares.yml Normal file
View File

@@ -0,0 +1,441 @@
emulator: ares
type: standalone
source: "https://github.com/ares-emulator/ares"
upstream: "https://github.com/ares-emulator/ares"
profiled_date: "2026-03-26"
core_version: "v147"
display_name: "ares"
cores: [ares]
mode: standalone
systems:
- arcade
- atari-2600
- colecovision
- myvision
- famicom
- famicom-disk-system
- game-boy
- game-boy-color
- game-boy-advance
- master-system
- game-gear
- sg-1000
- sc-3000
- mega-drive
- sega-32x
- mega-cd
- mega-cd-32x
- mega-ld
- msx
- msx2
- neo-geo
- neo-geo-pocket
- neo-geo-pocket-color
- nintendo-64
- nintendo-64dd
- pc-engine
- pc-engine-cd
- pc-engine-ld
- supergrafx
- supergrafx-cd
- sony-playstation
- saturn
- super-famicom
- wonderswan
- wonderswan-color
- pocket-challenge-v2
- zx-spectrum
- zx-spectrum-128
notes: |
Multi-system emulator by Near (byuu), successor to higan/bsnes. Focuses on
accuracy and preservation. 38 systems emulated.
Firmware identification uses SHA256 hashes. Filenames are user-defined; ares
scans a configured directory and matches by hash. EmuDeck installs ares as
Flatpak (dev.ares.ares), configures biosPath in settings.bml.
ref: desktop-ui/settings/firmware.cpp:116-136
Firmware path resolution: settings.paths.firmware (user override) or
{userData}/ares/Firmware/ (default). Per-system firmware assigned in
Settings > Firmware dialog or via scan-by-hash.
ref: desktop-ui/settings/settings.hpp:90-102, desktop-ui/desktop-ui.cpp:68-75
Systems with fully embedded firmware (no user files needed):
Game Boy (boot.rom), Game Boy Color (boot.rom), Mega Drive (TMSS),
Sega 32X (TMSS + vector + SH2 boot M/S), Nintendo 64 (PIF NTSC/PAL/SM5 +
CIC 6101/6102/6105/7101), Super Famicom (IPL + all coprocessor firmware:
DSP1-4, CX4, ST010, ST011, ST018, SGB1/2 boot ROMs), WonderSwan (boot.rom),
WonderSwan Color (boot.rom), Pocket Challenge V2 (boot.rom),
ZX Spectrum (BIOS), ZX Spectrum 128 (BIOS + sub ROM).
ref: mia/resource/resource.bml, mia/Firmware/
SFC coprocessor firmware auto-injected if missing from ROM image.
ref: mia/medium/super-famicom.cpp:42-62
Neo Geo BIOS: accepts ZIP archive (neogeo.zip) or direct binary. AES looks
for "neo-epo.bin" inside ZIP, MVS looks for "sp-45.sp1". Both apply byte-swap
after loading.
ref: mia/system/neo-geo-aes.cpp:12-30, mia/system/neo-geo-mvs.cpp:12-30
SFC subsystem ROMs (SuFami Turbo, Satellaview, Super Game Boy): loaded as
game cartridges via CLI args, not through the firmware system. EmuDeck creates
launcher shortcuts that pass these alongside game ROMs.
ref: emuDeckares.sh (EmuDeck repo)
Systems with no firmware: Arcade, Atari 2600, Famicom, MyVision, PC Engine,
SuperGrafx, SG-1000, SC-3000.
files:
# --- ColecoVision ---
- name: colecovision.rom
system: colecovision
required: true
mode: standalone
sha256: "990bf1956f10207d8781b619eb74f89b00d921c8d45c95c334c16c8cceca09ad"
validation: [sha256]
description: "ColecoVision BIOS"
source_ref: "desktop-ui/emulator/colecovision.cpp:12"
# --- Famicom Disk System ---
- name: disksys.rom
system: famicom-disk-system
required: true
mode: standalone
sha256: "fdc1a76e654feea993fcb38366e05ee5f4eb641f86fe6bebaeefd412e112dd72"
validation: [sha256]
description: "Famicom Disk System BIOS"
source_ref: "desktop-ui/emulator/famicom-disk-system.cpp:19"
# --- Game Boy Advance ---
- name: gba_bios.bin
system: game-boy-advance
required: true
mode: standalone
sha256: "fd2547724b505f487e6dcb29ec2ecff3af35a841a77ab2e85fd87350abd36570"
validation: [sha256]
description: "GBA BIOS"
source_ref: "desktop-ui/emulator/game-boy-advance.cpp:14"
# --- Game Gear ---
- name: bios.gg
system: game-gear
required: false
mode: standalone
sha256: "8c8a21335038285cfa03dc076100c1f0bfadf3e4ff70796f11f3dfaaab60eee2"
validation: [sha256]
description: "Game Gear BIOS"
source_ref: "desktop-ui/emulator/game-gear.cpp:12, mia/system/game-gear.cpp:8 (//optional)"
# --- Master System ---
- name: bios_U.sms
system: master-system
required: false
mode: standalone
sha256: "477617917a12a30f9f43844909dc2de6e6a617430f5c9a36306c86414a670d50"
validation: [sha256]
description: "Master System BIOS (US)"
source_ref: "desktop-ui/emulator/master-system.cpp:14, mia/system/master-system.cpp:8 (//optional)"
- name: bios_J.sms
system: master-system
required: false
mode: standalone
sha256: "67846e26764bd862f19179294347f7353a4166b62ac4198a5ec32933b7da486e"
validation: [sha256]
description: "Master System BIOS (Japan)"
source_ref: "desktop-ui/emulator/master-system.cpp:15"
- name: bios_E.sms
system: master-system
required: false
mode: standalone
sha256: "477617917a12a30f9f43844909dc2de6e6a617430f5c9a36306c86414a670d50"
validation: [sha256]
description: "Master System BIOS (Europe), same binary as US"
source_ref: "desktop-ui/emulator/master-system.cpp:16"
# --- Mega CD ---
# Also used by Mega CD 32X (desktop-ui/emulator/mega-cd-32x.cpp)
- name: bios_CD_U.bin
system: mega-cd
required: true
mode: standalone
sha256: "fb477cdbf94c84424c2feca4fe40656d85393fe7b7b401911b45ad2eb991258c"
validation: [sha256]
description: "Mega CD / Sega CD BIOS (US)"
source_ref: "desktop-ui/emulator/mega-cd.cpp:17"
- name: bios_CD_J.bin
system: mega-cd
required: true
mode: standalone
sha256: "7133fc2dd2fe5b7d0acd53a5f10f3d00b5d31270239ad20d74ef32393e24af88"
validation: [sha256]
description: "Mega CD BIOS (Japan)"
source_ref: "desktop-ui/emulator/mega-cd.cpp:18"
- name: bios_CD_E.bin
system: mega-cd
required: true
mode: standalone
sha256: "fe608a2a07676a23ab5fd5eee2f53c9e2526d69a28aa16ccd85c0ec42e6933cb"
validation: [sha256]
description: "Mega CD BIOS (Europe)"
source_ref: "desktop-ui/emulator/mega-cd.cpp:19"
# --- Mega LD (LaserActive SEGA PAC) ---
- name: mega_ld_bios_U.bin
system: mega-ld
required: true
mode: standalone
description: "LaserActive SEGA PAC BIOS (US)"
source_ref: "desktop-ui/emulator/mega-ld.cpp:18"
- name: mega_ld_bios_J.bin
system: mega-ld
required: true
mode: standalone
description: "LaserActive SEGA PAC BIOS (Japan)"
source_ref: "desktop-ui/emulator/mega-ld.cpp:19"
# --- MSX ---
- name: MSX.ROM
system: msx
required: true
mode: standalone
sha256: "413a2b601a94b3792e054be2439cc77a1819cceadbfa9542f88d51c7480f2ef0"
validation: [sha256]
description: "MSX BIOS ROM (Japan)"
source_ref: "desktop-ui/emulator/msx.cpp:15"
# --- MSX2 ---
- name: MSX2.ROM
system: msx2
required: true
mode: standalone
sha256: "0c672d86ead61a97f49a583b88b7c1905da120645cd44f0c9f2baf4f4631e0b1"
validation: [sha256]
description: "MSX2 main BIOS ROM (Japan)"
source_ref: "desktop-ui/emulator/msx2.cpp:15"
- name: MSX2EXT.ROM
system: msx2
required: true
mode: standalone
sha256: "6c6f421a10c428d960b7ecc990f99af1c638147f747bddca7b0bf0e2ab738300"
validation: [sha256]
description: "MSX2 sub ROM (Japan)"
source_ref: "desktop-ui/emulator/msx2.cpp:16"
# --- Neo Geo AES ---
- name: neo-epo.bin
system: neo-geo
required: true
mode: standalone
description: "Neo Geo AES BIOS. Accepts neogeo.zip (extracts neo-epo.bin) or direct file. Byte-swapped on load."
source_ref: "desktop-ui/emulator/neo-geo-aes.cpp:14, mia/system/neo-geo-aes.cpp:16"
# --- Neo Geo MVS ---
- name: sp-45.sp1
system: neo-geo
required: true
mode: standalone
description: "Neo Geo MVS BIOS. Accepts neogeo.zip (extracts sp-45.sp1) or direct file. Byte-swapped on load."
source_ref: "desktop-ui/emulator/neo-geo-mvs.cpp:15, mia/system/neo-geo-mvs.cpp:16"
# --- Neo Geo Pocket ---
- name: ngp_bios.rom
system: neo-geo-pocket
required: true
mode: standalone
sha256: "0293555b21c4fac516d25199df7809b26beeae150e1d4504a050db32264a6ad7"
validation: [sha256]
description: "Neo Geo Pocket BIOS"
source_ref: "desktop-ui/emulator/neo-geo-pocket.cpp:12"
# --- Neo Geo Pocket Color ---
- name: ngpc_bios.rom
system: neo-geo-pocket-color
required: true
mode: standalone
sha256: "8fb845a2f71514cec20728e2f0fecfade69444f8d50898b92c2259f1ba63e10d"
validation: [sha256]
description: "Neo Geo Pocket Color BIOS"
source_ref: "desktop-ui/emulator/neo-geo-pocket-color.cpp:12"
# --- Nintendo 64DD ---
- name: 64dd_ipl_J.bin
system: nintendo-64dd
required: true
mode: standalone
sha256: "806400ec0df94b0755de6c5b8249d6b6a9866124c5ddbdac198bde22499bfb8b"
validation: [sha256]
description: "Nintendo 64DD IPL ROM (Japan retail)"
source_ref: "desktop-ui/emulator/nintendo-64dd.cpp:17"
- name: 64dd_ipl_U.bin
system: nintendo-64dd
required: true
mode: standalone
sha256: "e9fec87a45fba02399e88064b9e2f8cf0f2106e351c58279a87f05da5bc984ad"
validation: [sha256]
description: "Nintendo 64DD IPL ROM (US dev kit)"
source_ref: "desktop-ui/emulator/nintendo-64dd.cpp:18"
- name: 64dd_ipl_DEV.bin
system: nintendo-64dd
required: true
mode: standalone
sha256: "9c2962a8b994a29e4cd04b3a6e4ed730a751414655ab6a9799ebf5fc08b79d44"
validation: [sha256]
description: "Nintendo 64DD IPL ROM (development)"
source_ref: "desktop-ui/emulator/nintendo-64dd.cpp:19"
# --- PC Engine CD ---
- name: syscard1.pce
system: pc-engine-cd
required: true
mode: standalone
sha256: "afe9f27f91ac918348555b86298b4f984643eafa2773196f2c5441ea84f0c3bb"
validation: [sha256]
description: "PC Engine CD-ROM2 System Card v1.0 (Japan). Also used by PC Engine LD."
source_ref: "desktop-ui/emulator/pc-engine-cd.cpp:15"
- name: syscard3.pce
system: pc-engine-cd
required: true
mode: standalone
sha256: "e11527b3b96ce112a037138988ca72fd117a6b0779c2480d9e03eaebece3d9ce"
validation: [sha256]
description: "Super CD-ROM2 System Card v3.0 (Japan). Also used by SuperGrafx CD as Arcade Card."
source_ref: "desktop-ui/emulator/pc-engine-cd.cpp:16, desktop-ui/emulator/supergrafx-cd.cpp:15"
- name: syscard3u.pce
system: pc-engine-cd
required: true
mode: standalone
sha256: "cadac2725711b3c442bcf237b02f5a5210c96f17625c35fa58f009e0ed39e4db"
validation: [sha256]
description: "TurboGrafx-CD Super System Card v3.0 (US)"
source_ref: "desktop-ui/emulator/pc-engine-cd.cpp:17"
- name: games_express.pce
system: pc-engine-cd
required: true
mode: standalone
sha256: "4b86bb96a48a4ca8375fc0109631d0b1d64f255a03b01de70594d40788ba6c3d"
validation: [sha256]
description: "Games Express CD Card (Japan). Also used by PC Engine LD."
source_ref: "desktop-ui/emulator/pc-engine-cd.cpp:18"
# --- PC Engine LD (LaserActive NEC PAC) ---
- name: pac-n10.pce
system: pc-engine-ld
required: true
mode: standalone
sha256: "0e87a3385a27b3a4cac51934819b7eefa5b3d690768d2495633838488cd0e2e4"
validation: [sha256]
description: "NEC PAC-N10 LaserActive module (US)"
source_ref: "desktop-ui/emulator/pc-engine-ld.cpp:20"
- name: pac-n1.pce
system: pc-engine-ld
required: true
mode: standalone
sha256: "459325690a458baebd77495c91e37c4dddfdd542ba13a821ce954e5bb245627f"
validation: [sha256]
description: "NEC PAC-N1 LaserActive module (Japan)"
source_ref: "desktop-ui/emulator/pc-engine-ld.cpp:21"
- name: pce-lp1.pce
system: pc-engine-ld
required: true
mode: standalone
sha256: "3f43b3b577117d84002e99cb0baeb97b0d65b1d70b4adadc68817185c6a687f0"
validation: [sha256]
description: "NEC PCE-LP1 LaserActive module (Japan)"
source_ref: "desktop-ui/emulator/pc-engine-ld.cpp:22"
# --- PlayStation ---
- name: scph5501.bin
system: sony-playstation
required: true
mode: standalone
sha256: "11052b6499e466bbf0a709b1f9cb6834a9418e66680387912451e971cf8a1fef"
validation: [sha256]
description: "PlayStation BIOS (US)"
source_ref: "desktop-ui/emulator/playstation.cpp:18"
- name: scph5500.bin
system: sony-playstation
required: true
mode: standalone
sha256: "9c0421858e217805f4abe18698afea8d5aa36ff0727eb8484944e00eb5e7eadb"
validation: [sha256]
description: "PlayStation BIOS (Japan)"
source_ref: "desktop-ui/emulator/playstation.cpp:19"
- name: scph5502.bin
system: sony-playstation
required: true
mode: standalone
sha256: "1faaa18fa820a0225e488d9f086296b8e6c46df739666093987ff7d8fd352c09"
validation: [sha256]
description: "PlayStation BIOS (Europe)"
source_ref: "desktop-ui/emulator/playstation.cpp:20"
# --- Saturn ---
- name: saturn_bios_U.bin
system: saturn
required: true
mode: standalone
description: "Sega Saturn BIOS (US)"
source_ref: "desktop-ui/emulator/saturn.cpp:14"
- name: saturn_bios_J.bin
system: saturn
required: true
mode: standalone
description: "Sega Saturn BIOS (Japan)"
source_ref: "desktop-ui/emulator/saturn.cpp:15"
- name: saturn_bios_E.bin
system: saturn
required: true
mode: standalone
description: "Sega Saturn BIOS (Europe)"
source_ref: "desktop-ui/emulator/saturn.cpp:16"
# --- SFC subsystem ROMs (loaded as game cartridges, not firmware) ---
- name: SGB1.sfc
system: super-famicom
required: false
mode: standalone
category: game_data
description: "Super Game Boy cartridge ROM. Loaded via CLI as SFC cartridge alongside GB game."
source_ref: "EmuDeck emuDeckares.sh (launcher)"
- name: SGB2.sfc
system: super-famicom
required: false
mode: standalone
category: game_data
description: "Super Game Boy 2 cartridge ROM. Loaded via CLI as SFC cartridge alongside GB game."
source_ref: "EmuDeck emuDeckares.sh (launcher)"
- name: STBIOS.bin
system: super-famicom
required: false
mode: standalone
category: game_data
description: "SuFami Turbo adapter BIOS. Loaded via CLI as SFC cartridge alongside SuFami games."
source_ref: "EmuDeck emuDeckares.sh (launcher)"
- name: BS-X.bin
system: super-famicom
required: false
mode: standalone
category: game_data
description: "Satellaview BS-X Town cartridge ROM. Loaded via CLI as SFC cartridge for BS games."
source_ref: "EmuDeck emuDeckares.sh (launcher)"

23
emulators/bigpemu.yml Normal file
View File

@@ -0,0 +1,23 @@
emulator: BigPEmu
type: standalone
source: "https://www.richwhitehouse.com/jaguar/"
upstream: "https://www.richwhitehouse.com/jaguar/"
profiled_date: "2026-03-26"
core_version: "1.12"
display_name: "BigPEmu (Atari Jaguar)"
cores:
- bigpemu
systems:
- atari-jaguar
- atari-jaguarcd
mode: standalone
notes: |
Closed-source Atari Jaguar and Jaguar CD emulator by Rich Whitehouse.
Built-in boot ROM emulation for both cartridge and CD. No external
BIOS or firmware files required. The emulator supports optional
"custom boot ROM images" via the UI (loading mode for specific
homebrew demos), but no fixed file path or file name is expected.
EmuDeck confirms: "No BIOS are required to play BigPEmu."
files: []

55
emulators/eden.yml Normal file
View File

@@ -0,0 +1,55 @@
emulator: Eden
type: standalone
core_classification: community_fork
source: "https://git.eden-emu.dev/eden-emu/eden"
upstream: "https://git.eden-emu.dev/eden-emu/eden"
profiled_date: "2026-03-26"
core_version: "0.1.1"
display_name: "Eden (Nintendo Switch)"
systems: [nintendo-switch]
analysis_date: "2026-03-26"
analysis_commit: "9347202 (depth=1)"
mode: standalone
# Eden is a community fork of yuzu, started by Camille LaVey.
# Key files loaded from <data_dir>/keys/ (fs_paths.h:20, path_util.cpp:158).
# On Linux: $XDG_DATA_HOME/eden/keys/
# On Windows: %APPDATA%/eden/keys/
# Firmware NCAs are installed via UI (Tools > Install Firmware), not placed as files.
# HLE fallbacks exist for fonts, timezone, system version, mii model, ng word lists.
files:
- name: "prod.keys"
required: true
path: "switch/"
mode: standalone
note: "Production keys for NCA decryption (master, key area, header, titlekek)"
source_ref: "src/core/crypto/key_manager.cpp:652-653"
- name: "title.keys"
required: false
path: "switch/"
mode: standalone
note: "Per-title encryption keys (rights_id to titlekey mappings)"
source_ref: "src/core/crypto/key_manager.cpp:655-656"
- name: "console.keys"
required: false
path: "switch/"
mode: standalone
note: "Console-specific keys (BIS, SD seed)"
source_ref: "src/core/crypto/key_manager.cpp:657-658"
- name: "key_retail.bin"
required: false
path: "switch/"
size: 160
mode: standalone
note: "Amiibo decryption keys (two InternalKey structs, 0x50 bytes each)"
source_ref: "src/core/hle/service/nfc/common/amiibo_crypto.cpp:281-302"
notes: |
Eden is a standalone Nintendo Switch emulator, community fork of yuzu by Camille LaVey.
dev.keys can be used instead of prod.keys when use_dev_keys is enabled (for Switch dev units).
Firmware (system NCAs) must be installed through Eden's UI from a firmware ZIP or NCA folder.
Required for commercial games. Homebrew (.nro, .nso) can run without keys or firmware.

37
emulators/model2.yml Normal file
View File

@@ -0,0 +1,37 @@
emulator: Model 2 Emulator
type: standalone
source: closed-source
upstream: closed-source
profiled_date: "2026-03-26"
core_version: "1.1a"
display_name: "Model 2 Emulator (Sega Model 2)"
cores:
- model2
systems:
- sega-model2
mode: standalone
notes: |
Closed-source Sega Model 2 arcade emulator by ElSemi, formerly Nebula Model 2.
Emulates Model 2, 2A, 2B, and 2C hardware. Windows-only, runs via Proton on
Linux (EmuDeck setup). Last official release 1.1a (2014-01-02).
Uses MAME-format merged ROM sets. Each game ZIP contains all required ROMs
(program, geometry, texture, sound, protection chips). No shared parent BIOS
set exists for Sega Model 2 hardware; each game board has its own ROM chips.
EmuDeck packages version 1.1c from SeongGino/edc-repo0004. Installs to
romsPath/model2/ with emulator_multicpu.exe as main binary. Ships with
Lua scripts for game-specific patches (widescreen, fixes). No checkBIOS
entry in EmuDeck; EMULATOR.INI references only a roms/ subdirectory.
Source code never published. Original distribution via nebula.emulatronia.com
(archived). PhilrocWP/Model2 GitHub repo no longer exists.
files: []
exclusion_note: >
Uses MAME-format merged ROM sets where all required ROMs are contained within
each game's ZIP file. No standalone BIOS or firmware files are loaded by the
emulator. The Sega Model 2 hardware has no shared system BIOS; each game board
has its own set of program, geometry, texture, and sound ROMs.

329
emulators/primehack.yml Normal file
View File

@@ -0,0 +1,329 @@
emulator: PrimeHack
type: standalone
core_classification: enhanced_fork
source: "https://github.com/shiiion/dolphin"
upstream: "https://github.com/dolphin-emu/dolphin"
profiled_date: "2026-03-26"
core_version: "1.0.8"
display_name: "PrimeHack (Dolphin fork for Metroid Prime)"
systems: [nintendo-gamecube, nintendo-wii]
analysis_date: "2026-03-26"
analysis_commit: "b10f147 (depth=1)"
mode: standalone
# PrimeHack is a Dolphin fork by shiiion adding mouselook controls for Metroid Prime Trilogy.
# BIOS loading code is identical to upstream Dolphin.
# File paths relative to Dolphin User directory:
# Standalone: User/GC/ and User/Wii/
# Sys/ is checked as fallback when not found in User/.
pack_structure:
standalone: ""
data_directories:
- ref: dolphin-sys
destination: "Sys"
source_ref: "Source/Core/Common/CommonPaths.h:128-141"
files:
# -- GameCube IPL (Boot ROM) --
# Region-specific, placed in GC/<region>/IPL.bin
# Checked in User/GC/<region>/ then Sys/GC/<region>/
- name: "IPL.bin"
path: "GC/USA/IPL.bin"
size: 2097152
required: false
mode: standalone
hle_fallback: true
note: "GameCube NTSC-U boot ROM. HLE available but real IPL needed for GC menu boot and accurate fonts"
source_ref: "Source/Core/Common/CommonPaths.h:138, Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:109-110"
- name: "IPL.bin"
path: "GC/EUR/IPL.bin"
size: 2097152
required: false
mode: standalone
hle_fallback: true
note: "GameCube PAL boot ROM"
source_ref: "Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:184"
- name: "IPL.bin"
path: "GC/JAP/IPL.bin"
size: 2097152
required: false
mode: standalone
hle_fallback: true
note: "GameCube NTSC-J boot ROM. JAP is the legacy directory name"
source_ref: "Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:186"
# -- DSP ROMs --
# Used by DSP LLE for accurate audio.
# PrimeHack ships free replacement ROMs, but real dumps improve accuracy.
# Searched in: User/GC/ then Sys/GC/
- name: "dsp_rom.bin"
path: "GC/dsp_rom.bin"
size: 8192
required: false
mode: standalone
hle_fallback: true
validation: [size]
known_hash_adler32: "0x66f334fe"
note: "DSP instruction ROM for LLE audio. Free replacement (v0.4) included"
source_ref: "Source/Core/Common/CommonPaths.h:135, Source/Core/Core/HW/DSPLLE/DSPLLE.cpp:87-117"
- name: "dsp_coef.bin"
path: "GC/dsp_coef.bin"
size: 4096
required: false
mode: standalone
hle_fallback: true
validation: [size]
known_hash_adler32: "0xf3b93527"
note: "DSP coefficient ROM for LLE audio. Free replacement included"
source_ref: "Source/Core/Common/CommonPaths.h:136, Source/Core/Core/DSP/DSPCore.cpp:32-38"
# -- GameCube Fonts --
# Bundled free alternatives exist but have padding differences causing misplaced text.
# If IPL dump is present, fonts are extracted from it instead (preferred).
# Searched in: Sys/GC/
- name: "font_western.bin"
path: "GC/font_western.bin"
size: 9589
required: false
mode: standalone
hle_fallback: true
note: "Windows-1252 font for GC/Wii text rendering. Free alternative bundled, real one from IPL dump preferred"
source_ref: "Source/Core/Common/CommonPaths.h:132, Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:131,203-218"
- name: "font_japanese.bin"
path: "GC/font_japanese.bin"
size: 303693
required: false
mode: standalone
hle_fallback: true
note: "Shift-JIS font for Japanese text. Free alternative bundled, real one from IPL dump preferred"
source_ref: "Source/Core/Common/CommonPaths.h:133, Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:130"
# -- GBA BIOS (for GC-GBA link) --
# Used by integrated mGBA core for GameCube-GBA connectivity.
# Loaded from User/GBA/gba_bios.bin.
- name: "gba_bios.bin"
path: "GBA/gba_bios.bin"
required: false
mode: standalone
hle_fallback: true
note: "GBA BIOS for GC-GBA link feature (uses integrated mGBA). Path configurable in settings"
source_ref: "Source/Core/Common/CommonPaths.h:144, Source/Core/Core/HW/GBACore.cpp:344-361"
# -- Wii System Files --
- name: "SYSCONF"
path: "Wii/shared2/sys/SYSCONF"
required: false
mode: standalone
hle_fallback: true
note: "Wii system configuration. Auto-generated by PrimeHack, can be imported from NAND backup"
source_ref: "Source/Core/Common/CommonPaths.h:117, Source/Core/Core/WiiRoot.cpp:266"
- name: "setting.txt"
path: "Wii/title/00000001/00000002/data/setting.txt"
size: 256
required: false
mode: standalone
hle_fallback: true
note: "Wii region/language settings. Auto-generated during Wii boot emulation"
source_ref: "Source/Core/Common/CommonPaths.h:152, Source/Core/Core/Boot/Boot_BS2Emu.cpp:377-454"
# -- Wii NAND Backup (BootMii) --
- name: "nand.bin"
path: null
required: false
mode: standalone
hle_fallback: true
note: "BootMii NAND backup. Can be imported to populate Wii NAND with channels, saves, system menu"
source_ref: "Source/Core/DiscIO/NANDImporter.cpp:26-89"
- name: "keys.bin"
path: null
size: 1024
required: false
mode: standalone
hle_fallback: true
note: "OTP/SEEPROM dump (Wii encryption keys). Needed if not appended to nand.bin for NAND import"
source_ref: "Source/Core/DiscIO/NANDImporter.cpp:19,76-88"
# -- Wii SD Card Image --
- name: "WiiSD.raw"
path: "Load/WiiSD.raw"
required: false
mode: standalone
hle_fallback: true
note: "Virtual SD card image for Wii homebrew. Auto-created, supports SD/SDHC up to 4GB"
source_ref: "Source/Core/Common/CommonPaths.h:149"
# -- Gecko Code Handler --
- name: "codehandler.bin"
path: null
required: false
mode: standalone
hle_fallback: true
note: "Gecko/Ocarina cheat code handler. Shipped with PrimeHack in Sys/"
source_ref: "Source/Core/Common/CommonPaths.h:154, Source/Core/Core/GeckoCode.cpp:121"
# -- Wii System Menu (WAD) --
- name: "Wii System Menu"
path: null
required: false
mode: standalone
hle_fallback: true
note: "Wii System Menu WAD. Installed to NAND via Tools > Install WAD, needed for Wii Menu boot"
source_ref: "Source/Core/DolphinQt/MenuBar.cpp:323,1219-1227"
# -- NAND Certificates (auto-extracted) --
- name: "clientca.pem"
path: "Wii/clientca.pem"
required: false
mode: standalone
hle_fallback: true
note: "SSL client certificate. Auto-extracted from IOS13 content during NAND import"
source_ref: "Source/Core/DiscIO/NANDImporter.cpp:201-285"
- name: "clientcakey.pem"
path: "Wii/clientcakey.pem"
required: false
mode: standalone
hle_fallback: true
note: "SSL client private key. Auto-extracted from IOS13 content during NAND import"
source_ref: "Source/Core/DiscIO/NANDImporter.cpp:237"
- name: "rootca.pem"
path: "Wii/rootca.pem"
required: false
mode: standalone
hle_fallback: true
note: "SSL root CA certificate. Auto-extracted from IOS13 content during NAND import"
source_ref: "Source/Core/DiscIO/NANDImporter.cpp:238"
# -- Realtek Bluetooth firmware (Wiimote passthrough) --
# Required for real Wiimote connectivity via USB Bluetooth adapters with Realtek chipsets.
# PrimeHack can auto-download these from gitlab.com/kernel-firmware/linux-firmware.
# Placed in Load/Firmware/rtl_bt/.
# ref: Source/Core/Core/IOS/USB/Bluetooth/RealtekFirmwareLoader.cpp:373-416
- name: "rtl8723a_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8723a_fw.bin"
required: false
mode: standalone
note: "Realtek 8723A BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:379"
- name: "rtl8723b_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8723b_fw.bin"
required: false
mode: standalone
note: "Realtek 8723B BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:381"
- name: "rtl8723d_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8723d_fw.bin"
required: false
mode: standalone
note: "Realtek 8723D BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:383"
- name: "rtl8761a_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8761a_fw.bin"
required: false
mode: standalone
note: "Realtek 8761A BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:385"
- name: "rtl8761bu_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8761bu_fw.bin"
required: false
mode: standalone
note: "Realtek 8761BU BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:387"
- name: "rtl8821a_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8821a_fw.bin"
required: false
mode: standalone
note: "Realtek 8821A BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:389"
- name: "rtl8821c_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8821c_fw.bin"
required: false
mode: standalone
note: "Realtek 8821C BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:391"
- name: "rtl8822b_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8822b_fw.bin"
required: false
mode: standalone
note: "Realtek 8822B BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:395"
- name: "rtl8822cu_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8822cu_fw.bin"
required: false
mode: standalone
note: "Realtek 8822CU BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:393"
- name: "rtl8851bu_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8851bu_fw.bin"
required: false
mode: standalone
note: "Realtek 8851BU BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:397"
- name: "rtl8852au_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8852au_fw.bin"
required: false
mode: standalone
note: "Realtek 8852AU BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:399"
- name: "rtl8852bu_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8852bu_fw.bin"
required: false
mode: standalone
note: "Realtek 8852BU BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:401"
- name: "rtl8852cu_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8852cu_fw.bin"
required: false
mode: standalone
note: "Realtek 8852CU BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:403"
- name: "rtl8852btu_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8852btu_fw.bin"
required: false
mode: standalone
note: "Realtek 8852BT/8852BE-VT BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:405"
- name: "rtl8922au_fw.bin"
path: "Load/Firmware/rtl_bt/rtl8922au_fw.bin"
required: false
mode: standalone
note: "Realtek 8922AU BT firmware for Wiimote passthrough"
source_ref: "RealtekFirmwareLoader.cpp:407"
notes:
hle_available: true
hle_note: >
PrimeHack provides HLE for GameCube IPL (boot ROM), DSP, and Wii system functions
(same as Dolphin). No BIOS files are strictly required for most games.
ipl_regions: ["USA", "EUR", "JAP", "JPN", "DEV"]
dsp_rom_note: >
DSP ROMs are verified at load time via Adler32 hash.
Official Nintendo hashes: irom=0x66f334fe, drom=0xf3b93527.
bt_passthrough_note: >
Bluetooth passthrough allows connecting real Wiimotes via USB Bluetooth adapters.
Realtek chipsets require firmware files in Load/Firmware/rtl_bt/.
PrimeHack can auto-download these from kernel-firmware/linux-firmware on GitLab.

36
emulators/supermodel.yml Normal file
View File

@@ -0,0 +1,36 @@
emulator: Supermodel
type: standalone
source: https://github.com/trzy/Supermodel
upstream: https://github.com/trzy/Supermodel
profiled_date: "2026-03-26"
core_version: "0.3a"
display_name: "Supermodel (Sega Model 3)"
cores:
- supermodel
systems:
- sega-model3
mode: standalone
notes: |
Open-source Sega Model 3 arcade emulator by Bart Trzynadlowski (trzy) and
contributors, under GPL-3.0. Emulates all three Model 3 steppings (1.0, 1.5,
2.0/2.1) including Real3D graphics, SCSP sound, DSB1/DSB2 MPEG music boards,
drive boards, and net board. Cross-platform (Windows, Linux, macOS).
Uses MAME-compatible ROM sets loaded from ZIP archives. GameLoader identifies
games by CRC32 checksums defined in Config/Games.xml. Parent/child ROM set
relationships exist between regional variants of the same game, not as shared
BIOS sets. No standalone BIOS or firmware files are loaded outside of game ZIPs.
EmuDeck installs the Flatpak package (com.supermodel3.Supermodel). Config
stored in ~/.supermodel/Config/. No checkBIOS entry in EmuDeck.
files: []
exclusion_note: >
The Sega Model 3 arcade hardware has no shared system BIOS. Each game board
contains its own program ROMs (CROM), video ROMs (VROM), sound program, sound
samples, and optional DSB/drive board ROMs, all contained within per-game
MAME-format ZIP archives. Supermodel loads all required data from these game
ZIPs via CRC32-based identification defined in Games.xml. No standalone BIOS
or firmware files are referenced by the emulator source code.

57
emulators/suyu.yml Normal file
View File

@@ -0,0 +1,57 @@
emulator: Suyu
type: standalone
core_classification: community_fork
source: "https://github.com/suyu-emu/suyu"
upstream: "https://github.com/suyu-emu/suyu"
profiled_date: "2026-03-26"
core_version: "Yuzu EA 4176 based"
display_name: "Suyu (Nintendo Switch)"
systems: [nintendo-switch]
analysis_date: "2026-03-26"
analysis_commit: "c096d16 (Hengle/suyu-emu mirror, depth=1)"
mode: standalone
# Suyu is a community fork of yuzu, started after yuzu's legal takedown.
# Key files loaded from <data_dir>/keys/ (fs_paths.h:20, path_util.cpp:124).
# On Linux: $XDG_DATA_HOME/suyu/keys/
# On Windows: %APPDATA%/suyu/keys/
# Firmware NCAs are installed via UI, not placed as files.
# HLE fallbacks exist for fonts, timezone, system version, mii model, ng word lists.
# Original repos (GitHub + GitLab) are DMCA'd. Analysis from community mirror.
files:
- name: "prod.keys"
required: true
path: "switch/"
mode: standalone
note: "Production keys for NCA decryption (master, key area, header, titlekek)"
source_ref: "src/core/crypto/key_manager.cpp:654"
- name: "title.keys"
required: false
path: "switch/"
mode: standalone
note: "Per-title encryption keys (rights_id to titlekey mappings)"
source_ref: "src/core/crypto/key_manager.cpp:657"
- name: "console.keys"
required: false
path: "switch/"
mode: standalone
note: "Console-specific keys (BIS, SD seed)"
source_ref: "src/core/crypto/key_manager.cpp:658"
- name: "key_retail.bin"
required: false
path: "switch/"
size: 160
mode: standalone
note: "Amiibo decryption keys (two InternalKey structs, 0x50 bytes each)"
source_ref: "src/core/hle/service/nfc/common/amiibo_crypto.cpp:273-294"
notes: |
Suyu is a standalone Nintendo Switch emulator, community fork of yuzu after legal takedown.
dev.keys can be used instead of prod.keys when use_dev_keys is enabled (for Switch dev units).
Firmware (system NCAs) must be installed through Suyu's UI from a firmware ZIP or NCA folder.
Required for commercial games. Homebrew (.nro, .nso) can run without keys or firmware.
Original repos DMCA'd by Nintendo. Analysis performed from community mirror (Hengle/suyu-emu).

38
emulators/xenia.yml Normal file
View File

@@ -0,0 +1,38 @@
emulator: Xenia Canary
type: standalone
core_classification: community_fork
source: "https://github.com/xenia-canary/xenia-canary"
upstream: "https://github.com/xenia-canary/xenia-canary"
profiled_date: "2026-03-26"
core_version: "canary"
display_name: "Xenia Canary (Xbox 360)"
cores:
- xenia
systems:
- microsoft-xbox-360
analysis_date: "2026-03-26"
analysis_commit: "3efc88a (depth=1)"
mode: standalone
notes: |
Xenia Canary is an experimental open-source Xbox 360 emulator (BSD license)
originally by Ben Vanik, now maintained by the xenia-canary community. Pure
HLE: the Xbox 360 kernel (xboxkrnl), XAM, and XBDM modules are fully
reimplemented in C++. XConfig system settings are hardcoded with user-
configurable overrides (language, region, audio, video). No BIOS, firmware,
NAND dump, flash dump, or keyvault file is loaded at any point.
EmuDeck installs xenia_canary.exe into the xbox360 ROMs folder. Config via
xenia-canary.config.toml. Game patches downloaded separately into patches/.
files: []
exclusion_note: >
Xenia is a pure high-level emulation (HLE) Xbox 360 emulator. The entire
Xbox 360 operating system (kernel, XAM dashboard services, XBDM debug
manager) is reimplemented in C++ as HLE modules loaded at startup
(emulator.cc:316-318). System configuration (XConfig) returns hardcoded
values from xboxkrnl_xconfig.cc. Memory, CPU (JIT), GPU, APU, and HID
subsystems are all software-emulated. No external BIOS, firmware, NAND
flash dump, or system files are loaded from disk. The wiki confirms:
"Xenia doesn't require any Xbox 360 system files."

59
emulators/yuzu.yml Normal file
View File

@@ -0,0 +1,59 @@
emulator: Yuzu
type: standalone
core_classification: official_port
source: "https://github.com/yuzu-emu-mirror/yuzu"
upstream: "https://github.com/yuzu-emu/yuzu"
profiled_date: "2026-03-26"
core_version: "EA 4176"
display_name: "Yuzu (Nintendo Switch)"
systems: [nintendo-switch]
analysis_date: "2026-03-26"
analysis_commit: "15e6e48 (yuzu-emu-mirror, depth=1)"
mode: standalone
# Yuzu is the original Nintendo Switch emulator by bunnei and the yuzu team.
# Legally shut down by Nintendo in March 2024. Citron, Suyu, Eden are community forks.
# Key files loaded from <data_dir>/keys/ (fs_paths.h:18, path_util.cpp:124).
# On Linux: $XDG_DATA_HOME/yuzu/keys/
# On Windows: %APPDATA%/yuzu/keys/
# Firmware NCAs are installed via UI (main.cpp:4160), not placed as files.
# HLE fallbacks exist for fonts, timezone, system version, mii model, ng word lists.
# Original repo DMCA'd by Nintendo. Analysis from community mirror (yuzu-emu-mirror).
files:
- name: "prod.keys"
required: true
path: "switch/"
mode: standalone
note: "Production keys for NCA decryption (master, key area, header, titlekek)"
source_ref: "src/core/crypto/key_manager.cpp:655-656"
- name: "title.keys"
required: false
path: "switch/"
mode: standalone
note: "Per-title encryption keys (rights_id to titlekey mappings)"
source_ref: "src/core/crypto/key_manager.cpp:659-660"
- name: "console.keys"
required: false
path: "switch/"
mode: standalone
note: "Console-specific keys (BIS, SD seed)"
source_ref: "src/core/crypto/key_manager.cpp:661-662"
- name: "key_retail.bin"
required: false
path: "switch/"
size: 160
mode: standalone
note: "Amiibo decryption keys (two InternalKey structs, 0x50 bytes each)"
source_ref: "src/core/hle/service/nfc/common/amiibo_crypto.cpp:273-294"
notes: |
Yuzu is the original standalone Nintendo Switch emulator, created by bunnei (author of Citra).
Legally shut down by Nintendo in March 2024 via lawsuit settlement. Permanently frozen.
dev.keys can be used instead of prod.keys when use_dev_keys is enabled (for Switch dev units).
Firmware (system NCAs) must be installed through Yuzu's UI from a firmware directory.
Required for commercial games. Homebrew (.nro, .nso) can run without keys or firmware.
Community forks: Citron, Suyu, Eden. Original GitHub repos DMCA'd.