Files
libretro/emulators/yuzu.yml
T
Abdessamad Derraz 9e054ee96c docs: add data_root to yuzu
Read at 15e6e48bef02, the analysis commit, from the Zenfone-5-X00QD-4-19/yuzu fork that still serves it.
2026-10-23 19:10:44 +02:00

73 lines
3.2 KiB
YAML

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"
upstream_gone: "GitHub withdrew the repository for legal reasons: the API answers HTTP 451 for both yuzu-emu/yuzu and the yuzu-emu-mirror copy. Observed 2026-09-04. No mirror found that serves file content."
core_version: "EA 4176"
display_name: "Yuzu (Nintendo Switch)"
cores:
- yuzu
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/prod.keys"
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/title.keys"
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/console.keys"
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/key_retail.bin"
size: 160
note: "Amiibo decryption keys (two InternalKey structs, 0x50 bytes each)"
source_ref: "src/core/hle/service/nfc/common/amiibo_crypto.cpp:273-294"
data_root:
windows:
path: "%APPDATA%/yuzu"
source_ref: "src/common/fs/path_util.cpp:90-96, CMakeLists.txt:67"
note: "A user folder beside yuzu.exe is used instead when it exists."
linux:
path: "$XDG_DATA_HOME/yuzu, else ~/.local/share/yuzu"
source_ref: "src/common/fs/path_util.cpp:105-115, 303-311"
note: "A user folder in the working directory is used instead when it exists."
android:
path: "Android/data/org.yuzu.yuzu_emu/files"
source_ref: "src/android/app/src/main/java/org/yuzu/yuzu_emu/utils/DirectoryInitialization.kt:41-42, src/common/fs/path_util.cpp:100-101"
note: "relWithDebInfo, debug and ea builds append .relWithDebInfo, .debug or .ea to the package name."
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.