Emulator binaries only. Neither zortos293/Lichii nor Frizti/Fritchii includes games, keys or firmware, and this site never hosts or links to them. After installing, see legal firmware & keys folder setup for exact Linux and macOS XDG paths.
Linux and macOS build matrix
Here is what actually exists across the official GitHub repositories for desktop Linux, ARM64 Linux, SteamOS and macOS:
| Platform & architecture | Native Lichii (build 316) | Fritchii (Fritchii v5.8.4) | CheezyEmu (build 12) |
|---|---|---|---|
| Linux x86_64 (Ubuntu 24.04+, Fedora 40+, Arch, SteamOS) | Native: lichii-linux-x86_64-pgo.AppImage & FUSE-free -pgo.tar.gz (glibc 2.39+) | No native binary (run Fritchii-v5.8.4-Windows-x64.zip via Proton / Wine, or compile from source since v5.6 #19) | Native: cheezyemu-linux-x86_64-pgo.AppImage with built-in FSR 3.1 & 2x FSR Frame Gen |
Linux ARM64 (aarch64)(ARM64 Linux SBCs & laptops) | Native: lichii-linux-aarch64-pgo.AppImage & FUSE-free -pgo.tar.gz (glibc 2.39+) | None (x86_64 Windows binary only) | Native: cheezyemu-linux-aarch64-pgo.AppImage & tar.gz |
| macOS 15+ (Apple Silicon) (M1 / M2 / M3 / M4) | Native (experimental): lichii-macos-arm64.dmg & .zip (MoltenVK + ARM64 JIT) | None (CrossOver/Whisky not recommended for Switch 2 AVX2/Vulkan) | Native (experimental): cheezyemu-macos-arm64.dmg & .zip (built-in FSR 3.1 & FG) |
| macOS (Intel x86_64) | No build | No build | No build |
Native Lichii Linux AppImage and aarch64 PGO
All eight Linux packages in zortos293/Lichii tag build-316 (commit 5a66c89) are built automatically by release-binaries.yml on Ubuntu 24.04 x86_64 and ARM64 runners, bundling Qt 6.8.3, FFmpeg 7.1, Wayland plugins (libqwayland-egl.so), and Feral GameMode:
| Platform | File name | Package type | Size | Bytes | Link |
|---|---|---|---|---|---|
| Linux x86_64 | lichii-linux-x86_64-pgo.AppImage | AppImage, PGO (recommended) | 157.8 MB | 157,764,088 | GitHub download |
| Linux x86_64 | lichii-linux-x86_64.AppImage | AppImage, standard | 128.5 MB | 128,543,224 | GitHub download |
| Linux x86_64 | lichii-linux-x86_64-pgo.tar.gz | tar.gz, PGO (recommended) | 169.4 MB | 169,440,465 | GitHub download |
| Linux x86_64 | lichii-linux-x86_64.tar.gz | tar.gz, standard | 138.2 MB | 138,225,656 | GitHub download |
| Linux ARM64 | lichii-linux-aarch64-pgo.AppImage | AppImage, PGO (recommended) | 137.8 MB | 137,751,048 | GitHub download |
| Linux ARM64 | lichii-linux-aarch64.AppImage | AppImage, standard | 109.4 MB | 109,378,056 | GitHub download |
| Linux ARM64 | lichii-linux-aarch64-pgo.tar.gz | tar.gz, PGO (recommended) | 148.7 MB | 148,700,640 | GitHub download |
| Linux ARM64 | lichii-linux-aarch64.tar.gz | tar.gz, standard | 118.6 MB | 118,621,431 | GitHub download |
| macOS (Apple Silicon) | lichii-macos-arm64.dmg | dmg | 90.3 MB | 90,259,795 | GitHub download |
| macOS (Apple Silicon) | lichii-macos-arm64.zip | zip | 80.9 MB | 80,894,070 | GitHub download |
- PGO AppImage (recommended on desktop Linux & SteamOS): download
lichii-linux-x86_64-pgo.AppImage(compiled with Clang PGO using Eglantine’s profile), mark it executable, and run it:
Since build 116 (#509), Lichii’s built-in updater replaces the AppImage in place, verifies GitHub’s SHA-256 digest, and keeps one rollback copy. If the PGO binary misbehaves on an older CPU, fall back to standardchmod +x lichii-linux-x86_64-pgo.AppImage ./lichii-linux-x86_64-pgo.AppImagelichii-linux-x86_64.AppImage. - Self-contained FUSE-free
tar.gz(build 150+, #1255): Ubuntu 24.04+ minimal installs, Fedora Atomic/Silverblue, Distrobox and Docker containers often omitlibfuse2. Extractlichii-linux-x86_64-pgo.tar.gzand runlichii/lichiidirectly — it is packed straight from the AppImageAppDirwith every shared library included. Both requireglibc 2.39or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch, CachyOS, openSUSE Tumbleweed). - Linux ARM64 (
lichii-linux-aarch64-pgo): targets desktop GNU/Linux on ARM64 hardware (glibc 2.39+, desktop X11/Wayland + Vulkan 1.3 drivers such as Mesa PanVK or Turnip on mainline Linux SBCs and ARM64 laptops). Note thatlichii-linux-aarch64is not an Android package — see howlichii-linux-aarch64differs from Android. - Recent Linux GPU, cache & audio improvements (builds 150–316): build 177 shipped optional experimental community
fsr4-vkFSR 4.1.1 on Linux x86_64 RDNA 2+ Mesa RADV (#1496); build 228 let Mesa RADV keep its own shader cache (Ocarina Castle Town 34 → 51 fps, #1653), gave Linux NVIDIA a 10 GiB driver shader cache folder (second boot 39 s vs 541 s, #1301), fixed RDNA 3/4 Mesa <26.2.5 intro hangs (#1203), RX 6000 RADV mesh crashes (#1732) and Intel Linux black screens (#1807), and suppressed false low-RAM warnings on 16 GB Steam Deck (#1506); and build 316 unbundleslibvulkan.so.1from Linux packages (#1854, resolving build 228’s Vulkan startup conflict), fixesHelp → Check for Updateson non-Debian Linux (#1842, #1844), and makes Loading Shaders wait only for the last two sessions’ pipelines (#1803). Known build 316 Linux note: a Nov 13–16Mesa mainregression hangs RDNA1 GPUs before “Press A” in Ocarina of Time — update Mesa (#2026), alongside open AMD Vulkan reset tracker#871. - Linux controller permissions (
hidraw): if SDL3 cannot open your DualSense or Switch pad on desktop Linux, copydist/72-eden-input.rulesto/etc/udev/rules.d/and reloadudevadm(exact rule on controller setup).
Running Fritchii on Linux via Wine or Proton
When you specifically want Fritchii’s Ocarina of Time features — upfront 120,461-shader pre-compilation, Ctrl+U 90–165 Hz mode, and the dedicated Saves manager — run Frizti’s Windows x64 build under Steam Proton or Wine-GE (handheld SteamOS specifics are in our Steam Deck AppImage vs Proton guide):
- Download
Fritchii-v5.8.4-Windows-x64.zip(72.6 MB) fromFrizti/Fritchiion GitHub and unzip the entireFritchii-v5.8.4/directory (for example~/Games/Fritchii-v5.8.4/). - Point Steam (Games > Add a Non-Steam Game), Lutris, or Heroic at
Fritchii-v5.8.4/lichii.exe— Frizti’s archive keeps upstream’s binary namelichii.exerather thanfritchii.exe(details in Fritchii v5 &lichii.exe). - In Steam’s Properties > Compatibility, enable Proton Experimental or GE-Proton. Because Fritchii renders straight to Vulkan, Proton translates Win32 calls and passes Vulkan straight through
winevulkanto your host Mesa RADV or NVIDIA driver with minimal GPU overhead. (If a fresh Wine prefix lacks MSVC DLLs, runFritchii-v5.8.4/vc_redist.x64.exeinside the same prefix once.) - Let Preparing shaders finish on first boot (~15 minutes once on an 8-core desktop CPU; converted for AMD drivers in v5.4, and skipped on routine updates from v5.8 onward). Keep
Graphics > Mesh Shaderson Automatic or Compute on AMD GPUs (#814). - Saves & migration between native Linux Lichii and Proton Fritchii: native Linux Lichii stores data in
~/.local/share/lichii/, whereas Steam Proton stores Fritchii v5.8+ data inside~/.local/share/Steam/steamapps/compatdata/<AppID>/pfx/drive_c/users/steamuser/AppData/Roaming/fritchii/. Use Fritchii’s home-screen Saves button (v5.8.3+) to export/import portable.zipbackups across both, and click Fix inside Saves (v5.8.4) if copied profiles appear orphaned.
Compiling Fritchii natively on Linux: Frizti/Fritchii is GPL-3.0 open source, and Fritchii v5.6 fixed a Linux build break (Fritchii #19). Developers with CMake 3.31+, Clang/GCC (C++20), Ninja and Qt 6 can clone github.com/Frizti/Fritchii and build a native binary locally, though Frizti only publishes official prebuilt zips for Windows x64.
Fritchii on Mac vs native Lichii on Apple Silicon
Searches for “Fritchii Mac” are common, so here is the exact macOS situation as of November 17, 2026:
- No Fritchii macOS build (and skip Wine/CrossOver for Switch 2):
Frizti/Fritchiiships no macOS binary. RunningFritchii-v5.8.4-Windows-x64.zipinside CrossOver, Whisky or Kegworks on an M-series Mac stacks Rosetta 2 x86_64 translation (without full AVX2 parity on older layers) on top ofwinevulkan→ MoltenVK → Metal, causing shader-compile hangs and Vulkan extension aborts on 12 GB Switch 2 titles. - Use native
lichii-macos-arm64.dmgor.zipinstead: mainlinezortos293/Lichiibuild 316 compiles natively for Apple Silicon (M1, M2, M3, M4) on macOS 15 Sequoia or newer (Intel Macs are unsupported). Build 70 brought Mario Kart World on an M4 Pro from ~9.5 to 30–38 fps via 16 KiB fastmem and MoltenVK; build 116 clamped framebuffers within Apple GPU limits (#427) and routed missing mesh shaders through compute (#569); build 150 fixed launching on macOS 15.0–15.3 (#1254); build 177–228 updated the bundle ID toio.github.zortos293.lichii(#1544) and enabled MoltenVK’s portability subset (#1368); and build 316 lifts MoltenVK’s 16-sampler limit (#1862) and honours reversed stick axes (#1927). CheezyEmu build 12 also ships an experimentalcheezyemu-macos-arm64.dmgwith built-in FSR 3.1 and Frame Generation. - First-launch Gatekeeper step (unnotarized app): drag
lichii.appto/Applications. Because CI builds are not signed with a paid Apple Developer ID, double-clicking shows an unverified-developer prompt. Right-click (or Control-click)lichii.appand choose Open (or approve it inSystem Settings > Privacy & Security), or clear Apple’s quarantine attribute in Terminal:xattr -dr com.apple.quarantine /Applications/lichii.app - macOS folder quirk (XDG paths, not
Library/Application Support): upstream’spath_util.cppandREADME.mduse XDG paths on macOS just like Linux — keys go in~/.local/share/lichii/keys/, firmware in~/.local/share/lichii/nand/system/Contents/registered/, and config in~/.config/lichii/(or simply useTools > Install Decryption KeysandTools > Install Firmwareinside the GUI; full map in firmware & keys setup).
Linux and macOS SHA-256 digests
Verify your download locally before running it with sha256sum <file> on Linux or shasum -a 256 <file> in macOS Terminal:
| File (Lichii build 316) | SHA-256 |
|---|---|
lichii-linux-x86_64-pgo.AppImage | 835daa49775bbd16ce57956f38a972d83a75afbec5ecae2413802938af543567 |
lichii-linux-x86_64.AppImage | 0c905dc25710894605883619d88fb915f2da03a4c26ae85e3a1b2b724d638b5e |
lichii-linux-x86_64-pgo.tar.gz | 123b904654e488f87bbfb38c35be884260344e67067973a72b42548496a91579 |
lichii-linux-x86_64.tar.gz | 425eb8fd9cf4174f079a048af454e692c12b10269d9f174e2598dc8108ebb342 |
lichii-linux-aarch64-pgo.AppImage | ac00f4e855edc30f5974e2bd1959c970a61a01aee333510fa3525d0910c23465 |
lichii-linux-aarch64.AppImage | 011d246c736b7dd6419da4cb73d1e35883946742c25fc0455dfa18e8ea7e337b |
lichii-linux-aarch64-pgo.tar.gz | 1dca77eb729b205b36e9093257797432875237f88f0e6f6cbf187e4d0a559994 |
lichii-linux-aarch64.tar.gz | 0fc2137f4f867dbc1f818f5a883dfc481a0c4b7ef0d6cb207d45fa3780a0418d |
lichii-macos-arm64.dmg | dadd5d979298ce53e9de856efda48d53c7189b405551dafb2f52283b025e0390 |
lichii-macos-arm64.zip | 916e96bd3a10509680e57870618348b7a75a7cad49f22e8359bef5a4c9376661 |
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.

