Which Linux package matches your computer?
The build 125 release notes list x86-64 and aarch64/ARM64 packages, each with AppImage and tar.gz options. Do not choose ARM64 simply because you use Linux: most Intel and AMD desktop PCs use x86-64.
You can inspect the current machine with:
uname -m
ldd --version
The first command reports the machine architecture. On a glibc-based distribution, the second can help identify the glibc version. Keep the output if you need to describe an installation problem.
AppImage or tar.gz?
| Format | Requirement in build 125 notes | When to consider it |
|---|---|---|
| AppImage | glibc 2.39 or newer | A self-contained package on a distribution meeting the stated baseline |
| tar.gz | Uses your system libraries; Qt 6 and usual dependencies must be installed | You can manage the libraries required by the build |
The release lists Ubuntu 24.04, Fedora 40, Debian 13 and Arch as examples for its AppImage baseline. That is not a guarantee about every driver or game on those distributions. An older glibc is a package compatibility issue, not evidence that your game is unsupported.
Do not replace core system libraries casually to force an AppImage to launch. Use the package appropriate for your system or review the project’s build documentation if you choose to build from source.
Launch an official AppImage
- Choose Linux in the download selector and verify the architecture.
- Download the file from the original GitHub release.
- In your file manager, enable the executable permission, or use the filename you actually downloaded in a command such as:
chmod +x lichii-linux-x86_64-pgo.AppImage
./lichii-linux-x86_64-pgo.AppImage
- If it fails, run it from a terminal and save the error text. A missing library, permission issue and GPU failure require different next steps.
- Once the emulator opens, use your legally obtained system and game files, add your game directory and configure input.
The repository’s inherited Quick Start has Steam Deck desktop-mode instructions. It is useful context for the inherited interface, but its Eden download names are not instructions to substitute an unrelated package for Lichii.
What should you record before testing a game?
Record the build, distro, CPU, GPU and graphics driver or Mesa version. Linux reports using RADV may differ from reports using another driver on the same card. Consult how to read compatibility reports before importing a result from Windows.
For Ocarina of Time on AMD graphics, the intro-to-3D crash guide links the active issue tracker. Avoid repeated whole-system freezes just to reproduce an already-matching report. Capture the relevant details and follow the source’s current state.
Before changing builds, read update and backup. Separate AppImage files can still access the same emulator data.