Files
libretro/emulators/yuzu.yml
T
Abdessamad Derraz da6e7144bb fix: read yuzu keys from its keys folder
fs_paths.h:18 KEYS_DIR "keys", path_util.cpp:124; key_manager.cpp:643 and amiibo_crypto.cpp:274 read there.
2026-10-24 00:48:55 +02:00

76 lines
3.5 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"
source_commit: "15e6e48bef0216480661444a8d8b348c1cca47bb"
pin_frozen: "The analysed revision, the one the EA 4176 build documented here comes from. yuzu stopped in March 2024 and the mirror's later commits are a fork's."
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. The fork Zenfone-5-X00QD-4-19/yuzu, pushed 2024-03-05, still serves the analysed commit."
source_mirror: "https://github.com/Zenfone-5-X00QD-4-19/yuzu"
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: "keys/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: "keys/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: "keys/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: "keys/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.