Strict legal & safety policy: Neither Lichii nor Fritchii ships keys, firmware or games, and this site hosts zero files and provides zero links to download prod.keys, firmware packs, BIOS archives or ROMs. Only use system files legally dumped from your own console. Websites advertising a “Lichii firmware + keys pack” are unauthorized and a frequent source of malware (see Is Lichii safe?).
Official setup via the Tools menu
Upstream’s docs/user/QuickStart.md recommends installing both keys and firmware through the built-in Qt interface rather than copying files manually, because the GUI validates filenames, clears stale registered NCAs, and initializes NAND directories cleanly:
- Launch the desktop GUI first: open
lichii.exeon Windows, the.AppImage/lichiibinary on Linux, orlichii.appon macOS (upstream’s README notes that command-lineeden-clishould only be used after you have initialized keys and folders once in the GUI). - Install decryption keys: in the top menu bar, click
Tools > Install Decryption Keysand select your legally dumpedprod.keysfile. (If you also have an optionaltitle.keysfile, clickFile > Open Lichii Folder— orOpen Fritchii Folder— and droptitle.keysinto thekeyssubfolder alongsideprod.keys.) - Install system firmware: click
Tools > Install Firmwareand choose either:Install from a ZIP— points directly at a standard.ziparchive containing your dumped firmware.ncafiles.Install from Folder— points at an unpacked directory containing those.ncafiles.
nand/system/Contents/registered/automatically. - Add your game directory: double-click the central prompt on the home screen (or open
Emulation > Configure... > General) to add the folder holding your legally dumped game packages (.nsp,.xci,.nup, or compressed single-file.nxarchives supported since Lichii build 130 #923 and Fritchii v5.7).
Exact firmware and prod.keys folder paths by OS
Verified from src/common/fs/path_util.cpp and fs_paths.h in zortos293/Lichii, here is where each emulator and operating system reads keys, registered firmware, saves, shader caches and logs:
| Emulator & OS | Decryption keys (prod.keys) | Registered firmware (.nca files) | Saves, config & log paths |
|---|---|---|---|
| Lichii (Windows) build 150+ | %APPDATA%\lichii\keys\prod.keys | %APPDATA%\lichii\nand\system\Contents\registered\ | Saves: %APPDATA%\lichii\nand\user\save\Config: %APPDATA%\lichii\config\Log: %APPDATA%\lichii\log\eden_log.txt |
| Fritchii (Windows) v5.8 – v5.8.4 | %APPDATA%\fritchii\keys\prod.keys | %APPDATA%\fritchii\nand\system\Contents\registered\ | Saves: %APPDATA%\fritchii\nand\user\save\Save backups: nand\user\save-backups\ |
| Lichii (Linux & macOS) XDG layout | ~/.local/share/lichii/keys/prod.keys | ~/.local/share/lichii/nand/system/Contents/registered/ | Saves: ~/.local/share/lichii/nand/user/save/Config: ~/.config/lichii/Cache: ~/.cache/lichii/ |
| Fritchii via Steam Proton (Linux / Steam Deck) | .../compatdata/<AppID>/pfx/drive_c/users/steamuser/AppData/Roaming/fritchii/keys/prod.keys | .../Roaming/fritchii/nand/system/Contents/registered/ | Full prefix root under ~/.local/share/Steam/steamapps/compatdata/<AppID>/ (Linux & Proton guide) |
| CheezyEmu / Eden (legacy shared folder) | %APPDATA%\eden\keys\prod.keys(Linux: ~/.local/share/eden/keys/) | %APPDATA%\eden\nand\system\Contents\registered\ | Used by CheezyEmu, Eden, and Lichii builds prior to build 150 |
macOS path heads-up: unlike native Cocoa apps that use ~/Library/Application Support/, Lichii’s path_util.cpp uses XDG directories on macOS too (~/.local/share/lichii, ~/.config/lichii, and ~/.cache/lichii, unless overridden by XDG_DATA_HOME / XDG_CONFIG_HOME). Using File > Open Lichii Folder inside the app always opens the active directory in Finder or Explorer.
Portable user folder and safe migration
- Portable
user/directory mode: if you want to keep keys, firmware, saves and shaders on an external SSD or separate per-build test folder without touching%APPDATA%, create an empty folder nameduserin the exact same folder aslichii.exe(Windows) or your launch working directory (Linux/macOS) before opening the app. Both Lichii and Fritchii switch automatically touser/keys/,user/nand/system/Contents/registered/,user/config/anduser/cache/. - Automatic migration from Eden / Lichii:
- Lichii build 150+ (#1253): imports your existing keys, NAND and saves from
%APPDATA%\eden/~/.local/share/edenintolichiion first launch when safe. - Fritchii v5.8 – v5.8.4: checks both
%APPDATA%\edenand%APPDATA%\lichiion first run, picks whichever has your newest saves, and asks which items to copy (Saves, keys & profiles and Settings ticked by default; Mods & updates unticked so broken mods stay behind). You can re-run this anytime fromHelp > Copy Data from Eden or Lichii..., or copy saves two-way via the home-screen Saves button (v5.8.3+) and repair mismatched profile IDs with Saves > Fix (v5.8.4).
- Lichii build 150+ (#1253): imports your existing keys, NAND and saves from
Firmware vs keys and version matching
- What
prod.keyshandles vs what Firmware handles:prod.keyssupplies console-derived AES/NCA header and master keys needed to parse and decrypt game containers (.nsp,.xci,.nup,.nx) and updates. Registered system firmware innand/system/Contents/registered/supplies shared system archives, Mii/profile data, time-zone data and Switch/Switch 2 font glyphs (for instance, controller face-button icons in Mario Tennis Fever showed “?” without firmware fonts until Lichii build 125 added a synthesized glyph fallback alongside firmware font loading, #691 & #821). - Matching firmware and key generations: use
prod.keysand firmware dumped from the same updated console generation required by your game updates. Always install or upgrade firmware throughTools > Install Firmwarerather than dragging new.ncafiles on top of old ones in File Explorer — manually mixing two firmware versions insideContents/registered/leaves duplicate system NCAs and causes startup aborts.
Fixing common initialization and missing-key errors
| Symptom or error message | Root cause | Verified fix |
|---|---|---|
| “Decryption keys missing” badge in game list | Added in Lichii build 316 (#1503) so games are no longer hidden when keys are missing or incomplete. | Click Tools > Install Decryption Keys and select a valid prod.keys. Build 316 also derives missing key generations automatically when the underlying master keys are present in prod.keys. |
| Missing specific key slot error (formerly “bad header, please redump”) | Before build 316 (#1457), a missing newer key generation falsely blamed a corrupt game dump. | Check the exact key name shown in the dialog or log/eden_log.txt; re-dump prod.keys from your updated console so the required master-key generation is present. |
prod.keys placed in keys/ is ignored on Windows | Windows File Explorer’s “Hide extensions for known file types” saved the file as prod.keys.txt. | Enable View > Show > File name extensions in Explorer and rename prod.keys.txt to prod.keys, or install it through Tools > Install Decryption Keys. |
| Game crashes or hangs when an older game update is installed | Incompatible or stale update NCA registered in NAND alongside a base dump. | Update to Lichii build 316 (#1504 ignores incompatible older updates cleanly, noted in Hyrule Warriors: Age of Imprisonment), or right-click the title > Remove > Remove Installed Update and reinstall the matching update. |
Corrupted NAND after manual .nca drag-and-drop | Leftover mixed firmware NCAs inside nand/system/Contents/registered/. | Close the emulator, empty nand/system/Contents/registered/ (never delete nand/user/save/!), reopen the GUI, and run Tools > Install Firmware cleanly. |
Recommended SDL3 controllers
Lichii reads gamepads through SDL3 (including HID command 300 motion). Standard Xbox pads have no gyroscope, so games that use motion aiming or tilt steering (such as Mario Kart World or Ocarina of Time) need a DualSense or aSwitch-style pad, while TMR/Hall sticks prevent drift:
| Controller | Gyro in Lichii (SDL3) | Why pick it | Amazon |
|---|---|---|---|
| Sony DualSense | Yes (USB-C & Bluetooth) | Confirmed working in Mario Kart World (#523); full SDL3 gyro on Windows, macOS & Linux | View on Amazon → |
| GameSir Cyclone 2 | Switch mode / PC | TMR electromagnetic sticks (no drift) + Hall/micro-switch triggers for PC & Switch 2 | View on Amazon → |
| 8BitDo Ultimate 2 Bluetooth | Switch mode | Nintendo ABXY layout, TMR sticks and charging dock for Switch 2 & Windows | View on Amazon → |
| Xbox Wireless Controller | No gyro | Plug-and-play XInput on Windows & Steam Deck (named in upstream Deck notes) | View on Amazon → |
As an Amazon Associate, this site earns from qualifying purchases. Full button profiles and Linux udev rules: controller setup guide.

