Citra
Citra emulates Nintendo 3DS. It reads 4 files, none of them required: it starts games without them.
Run on its own, the app keeps its data in this folder:
%APPDATA%/Citra/
User beside the executable when that folder exists.
Source: src/, src/, src/, src/
~/
$XDG_DATA_HOME/citra-emu or ~/.local/share/citra-emu when an XDG folder from an earlier setup exists. user in the working directory when that folder exists.
Source: src/, src/, src/
$XDG_DATA_HOME/citra-emu/, else ~/.local/share/citra-emu/
User in the working directory when that folder exists.
Source: src/, src/, src/, src/
<folder picked at first launch>/
Source: src/, src/, src/
About this profile
Install this emulator's files
For Citra inside RetroArch, RetroBat or another setup. The installer finds your setup and its BIOS folder, then downloads only the files this emulator reads there and checks each one.
Open the Start menu. Type PowerShell and open it. Paste the line. Press Enter.
&([scriptblock]::Create((irm https://abdess.github.io/retrobios/i.ps1))) --emulator citraOpen Terminal, in Applications, then Utilities. Paste the line. Press Return.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator citraOpen a terminal. Paste the line. Press Enter.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator citraSwitch to Desktop Mode. Open Konsole. Paste with Ctrl+Shift+V. Press Enter.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator citraInstall Termux, a terminal app. Run pkg install python and termux-setup-storage once. Then paste the line. Press Enter.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator citraOpen a terminal on the device. Or connect from a computer with SSH, a terminal over the network. Paste the line. Press Enter.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator citraTechnical notes
Citra 3DS emulator. Upstream taken down March 2024 (Nintendo lawsuit).
Mirror: https://github.com/citra-mirror/citra
Data dir: {save_dir}/Citra/ under the default "LibRetro Default" option
citra_use_libretro_save_path, {system_dir}/Citra/ only when the frontend
gives no save directory. sysdata/ sits under it.
ref: src/, src/,
src/, src/common/file_util.cpp:855
The core reports library_name "Citra".
ref: src/
HLE for most services. Embedded open-source replacements for shared font,
Mii data, country list, and bad word list compiled into the binary.
ref: src/, 133-167
firmware_count absent in .info (= 0). All files optional.
4 files: 0 required, 4 optional. 1 has an HLE fallback.
In this collection: 4 in repo and 0 missing.
Optional
Section titled “Optional”aes_keys.txt optional in repo
AES encryption keys
- Path:
Citra/sysdata/aes_keys.txt - Read from: the save directory, not the BIOS directory (libretro build)
- System: Nintendo 3DS
- needed for encrypted games
- Collection copy:
bios/Nintendo/3DS/aes_keys.txt - Platforms:
aes_keys.txt: BizHawk, EmuDeck.bios/aes_keys.txt: RetroDECK
Source
- Source:
src/core/ hw/ aes/ key.cpp:207-208
boot9.bin optional in repo
ARM9 bootrom
- Path:
Citra/sysdata/boot9.bin - Read from: the save directory, not the BIOS directory (libretro build)
- System: Nintendo 3DS
- provides AES and RSA keys
- Size: 64.0 KB
- Collection copy:
bios/Nintendo/3DS/boot9.bin
Validation and source
- Validation: size
- Source:
src/,core/ hw/ aes/ key.cpp:162-172 src/core/hw/rsa/rsa.cpp:55-65
shared_font.bin optional in repo HLE fallback
system shared font (legacy format)
- Path:
Citra/sysdata/shared_font.bin - Read from: the save directory, not the BIOS directory (libretro build)
- System: Nintendo 3DS
- fallback to embedded open-source replacement font
- Collection copy:
bios/Nintendo/ 3DS/ Citra/ sysdata/ shared_font.bin
Source
seeddb.bin optional in repo
game seed database
- Path:
Citra/sysdata/seeddb.bin - Read from: the save directory, not the BIOS directory (libretro build)
- System: Nintendo 3DS
- needed for seed-encrypted games (9.6+ titles), creates empty if missing
- Collection copy:
bios/Nintendo/ 3DS/ Citra/ sysdata/ seeddb.bin - Platforms:
seeddb.bin: BizHawk
Source
Next steps
Section titled “Next steps”- Get your files, for the setup you play on
- Every system, and the files each one needs
- When a game does not start