Installing Kaichii¶
Builds are on the releases page. Each release comes in a standard and a PGO build: the same program, compiled with profiles recorded while playing. Take the PGO one when your system has it.
Linux¶
Download kaichii-linux-x86_64-pgo.AppImage (or kaichii-linux-aarch64-pgo.AppImage on ARM), make
it executable and run it:
chmod +x kaichii-linux-x86_64-pgo.AppImage
./kaichii-linux-x86_64-pgo.AppImage
The AppImage carries everything it needs. It runs on systems with glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch and the distributions based on them.
- It says it needs FUSE. Install your distribution's FUSE 2 package (
libfuse2t64on Ubuntu 24.04,fuse2on Arch), or start it withAPPIMAGE_EXTRACT_AND_RUN=1 ./kaichii-…AppImage. - The applications menu and the taskbar icon. Desktops show an app's icon from its entry in the applications menu, which an AppImage doesn't install by itself. The first time it starts, Kaichii offers to add itself there; say yes and the taskbar shows its icon. Add Kaichii to the applications menu in Configure > Interface changes it later.
- You'd rather use your system's libraries. The
.tar.gzholds the same programs without their libraries; Qt 6 and the usual libraries must be installed.
Windows¶
Download kaichii-windows-x86_64-pgo.zip, extract the whole folder wherever you like, and run
kaichii.exe.
- Windows protected your PC. SmartScreen doesn't know the program yet: choose More info and Run anyway.
- A missing
VCRUNTIME140.dllorMSVCP140.dll. Install Microsoft's Visual C++ Redistributable for x64.
macOS¶
Download kaichii-macos-arm64.zip (Apple Silicon, macOS 15 or newer) and unzip it. The app isn't
notarized, so the first time right-click it and choose Open, or run
xattr -dr com.apple.quarantine kaichii.app. macOS support is experimental.
Updates¶
Kaichii looks for a newer build each time it starts and offers to install it. The AppImage and the Windows folder update themselves; your saves and settings stay. Turn the check off with Check for updates in Configure > Interface (or type its name in the settings search).
Where your data lives¶
Kaichii keeps saves, keys, firmware, settings and shader caches in a folder named eden (the name
of an earlier project, kept so nothing gets lost):
| System | Folder |
|---|---|
| Linux | ~/.local/share/eden (data), ~/.config/eden (settings), ~/.cache/eden (caches) |
| Windows | %APPDATA%\eden |
File > Open Kaichii Folders opens them. On Windows, a folder named user next to kaichii.exe
makes Kaichii portable: everything is kept there instead.
Coming from another emulator¶
Lichii and Eden use the same eden folder, so Kaichii finds your saves, settings and caches as they
are. From yuzu and other emulators based on it, Kaichii offers to import their data on its first
start. A build still named Lichii won't update itself to Kaichii: download Kaichii once by hand.
Next: First launch.