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).