Lichii app icon: a coral lychee fruit with a green leaf on a deep green rounded square Lichii

Guide

Setting Up Lichii for the First Time: Games Folder, Keys and Firmware

First setup in Lichii: which folder to point at, where keys and firmware go, and the small order of operations that makes games appear and start.

Ocarina of Time title screen running in Lichii

The right order matters

First setup in the lichii emulator is a sequence, not a pile. Keys and firmware first, games folder second, settings last. Done in that order, the game list fills correctly and the first launch tests the whole chain at once. Done backwards, each step hides the errors of the previous one. The tested build and its full review live at lichii emulator.

Everything you add comes from your own console and your own game copies. The emulator ships with none of it, by design, and any source offering a bundle with games included is a source to walk away from.

Adding the games folder

Point the app at the folder that holds your dumps, not at a single game file buried three levels deep. Single files and extracted folders both work; an extracted game needs its files in the expected layout, with the main executable where the emulator looks for it.

If a loose folder game does not appear in the list, the app may need the all files access permission to read it. Grant it, rescan, and the title should list with its icon and name pulled from the game itself.

First launch checks

Launch your lightest game first, not your most wanted one. A title screen that renders, sound that plays and a menu that responds prove the keys, firmware, folder and renderer in one minute. Save the flagship title for when the chain is proven.

If the first launch fails, the log file is your friend: the emulator writes eden_log.txt, and its last lines usually name the missing piece in plain terms. The black screen checklist works through those causes in the same order the log reports them.

Related reading: the black screen checklist.

Related reading: the flagship game settings.

Quick Answers

Where do keys and firmware come from?

From your own console. You dump them from hardware you own; the emulator includes none and this site supplies none.

My game does not appear in the list. Why?

Usually the folder path or the permission. Point at the folder holding the game, grant all files access for loose folders, and rescan.

Can Lichii read game updates and DLC too?

Yes. The emulator supports keeping a game, its updates and its DLC together, including in a single .nup package where the game list shows the update version.