emulator: Citra Canary
type: libretro
core_classification: community_fork
source: "https://github.com/libretro/citra"
upstream: "https://github.com/citra-emu/citra"
profiled_date: "2026-03-23"
core_version: "Git"
display_name: "Nintendo - 3DS (Citra Canary/Experimental)"
cores: [citra_canary]
systems:
  - nintendo-3ds

notes: |
  Canary branch of libretro/citra. Older codebase than master branch (citra core).
  Missing boot9.bin, sector0x96.bin, seeddb.bin support present in master.
  Seed crypto unimplemented (src/core/file_sys/ncch_container.cpp:169).
  Upstream citra-emu/citra taken down March 2024 (Nintendo lawsuit).
  Mirror: https://github.com/citra-mirror/citra

  Data dir: {system_dir}/Citra/sysdata/
  ref: src/citra_libretro/citra_libretro.cpp:305-314

  Embedded open-source replacements for shared font, country list, bad word list.
  ref: src/core/file_sys/archive_ncch.cpp:142-147

  firmware_count absent in .info (= 0).

files:
  - name: aes_keys.txt
    path: "Citra/sysdata/aes_keys.txt"
    system: nintendo-3ds
    required: false
    note: "AES encryption keys for decrypting 3DS content"
    source_ref: "src/core/hw/aes/key.cpp:71-131"

  - name: shared_font.bin
    path: "Citra/sysdata/shared_font.bin"
    system: nintendo-3ds
    required: false
    hle_fallback: true
    note: "system shared font, falls back to embedded open-source replacement"
    source_ref: "src/core/hle/service/apt/apt.cpp:168-200"