Fritchii & Lichii on Linux & macOS

Frizti/Fritchii publishes Windows x64 .zip releases only (Fritchii-v5.8.4-Windows-x64.zip) — there is no native Fritchii Linux AppImage or macOS .dmg, whereas mainline zortos293/Lichii (build 316, published November 16, 2026) ships 10 native Linux and macOS packages: x86_64 and aarch64 PGO AppImages, self-contained FUSE-free tar.gz archives, and Apple Silicon macOS 15+ builds. On Linux you can either run native Lichii directly on Wayland / Mesa RADV or run Fritchii’s Windows zip through Wine / Steam Proton; on Apple Silicon Macs, native lichii-macos-arm64 is the right path. Checked on November 17, 2026.

Advertisement

Lichii Emulator Guide / Linux & macOS

Die photograph of the NVIDIA Tegra X1 chip, its blocks lit in violet, yellow and pink

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:

Advertisement
Platform & architectureNative 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 buildNo buildNo 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:

PlatformFile namePackage typeSizeBytesLink
Linux x86_64lichii-linux-x86_64-pgo.AppImageAppImage, PGO (recommended)157.8 MB157,764,088GitHub download
Linux x86_64lichii-linux-x86_64.AppImageAppImage, standard128.5 MB128,543,224GitHub download
Linux x86_64lichii-linux-x86_64-pgo.tar.gztar.gz, PGO (recommended)169.4 MB169,440,465GitHub download
Linux x86_64lichii-linux-x86_64.tar.gztar.gz, standard138.2 MB138,225,656GitHub download
Linux ARM64lichii-linux-aarch64-pgo.AppImageAppImage, PGO (recommended)137.8 MB137,751,048GitHub download
Linux ARM64lichii-linux-aarch64.AppImageAppImage, standard109.4 MB109,378,056GitHub download
Linux ARM64lichii-linux-aarch64-pgo.tar.gztar.gz, PGO (recommended)148.7 MB148,700,640GitHub download
Linux ARM64lichii-linux-aarch64.tar.gztar.gz, standard118.6 MB118,621,431GitHub download
macOS (Apple Silicon)lichii-macos-arm64.dmgdmg90.3 MB90,259,795GitHub download
macOS (Apple Silicon)lichii-macos-arm64.zipzip80.9 MB80,894,070GitHub 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:
    chmod +x lichii-linux-x86_64-pgo.AppImage
    ./lichii-linux-x86_64-pgo.AppImage
    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 standard lichii-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 omit libfuse2. Extract lichii-linux-x86_64-pgo.tar.gz and run lichii/lichii directly — it is packed straight from the AppImage AppDir with every shared library included. Both require glibc 2.39 or 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 that lichii-linux-aarch64 is not an Android package — see how lichii-linux-aarch64 differs from Android.
  • Recent Linux GPU, cache & audio improvements (builds 150–316): build 177 shipped optional experimental community fsr4-vk FSR 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 unbundles libvulkan.so.1 from Linux packages (#1854, resolving build 228’s Vulkan startup conflict), fixes Help → Check for Updates on 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–16 Mesa main regression 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, copy dist/72-eden-input.rules to /etc/udev/rules.d/ and reload udevadm (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):

  1. Download Fritchii-v5.8.4-Windows-x64.zip (72.6 MB) from Frizti/Fritchii on GitHub and unzip the entire Fritchii-v5.8.4/ directory (for example ~/Games/Fritchii-v5.8.4/).
  2. 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 name lichii.exe rather than fritchii.exe (details in Fritchii v5 & lichii.exe).
  3. 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 winevulkan to your host Mesa RADV or NVIDIA driver with minimal GPU overhead. (If a fresh Wine prefix lacks MSVC DLLs, run Fritchii-v5.8.4/vc_redist.x64.exe inside the same prefix once.)
  4. 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 Shaders on Automatic or Compute on AMD GPUs (#814).
  5. 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 .zip backups 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/Fritchii ships no macOS binary. Running Fritchii-v5.8.4-Windows-x64.zip inside CrossOver, Whisky or Kegworks on an M-series Mac stacks Rosetta 2 x86_64 translation (without full AVX2 parity on older layers) on top of winevulkan → MoltenVK → Metal, causing shader-compile hangs and Vulkan extension aborts on 12 GB Switch 2 titles.
  • Use native lichii-macos-arm64.dmg or .zip instead: mainline zortos293/Lichii build 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 to io.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 experimental cheezyemu-macos-arm64.dmg with built-in FSR 3.1 and Frame Generation.
  • First-launch Gatekeeper step (unnotarized app): drag lichii.app to /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.app and choose Open (or approve it in System 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’s path_util.cpp and README.md use 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 use Tools > Install Decryption Keys and Tools > Install Firmware inside 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.AppImage835daa49775bbd16ce57956f38a972d83a75afbec5ecae2413802938af543567
lichii-linux-x86_64.AppImage0c905dc25710894605883619d88fb915f2da03a4c26ae85e3a1b2b724d638b5e
lichii-linux-x86_64-pgo.tar.gz123b904654e488f87bbfb38c35be884260344e67067973a72b42548496a91579
lichii-linux-x86_64.tar.gz425eb8fd9cf4174f079a048af454e692c12b10269d9f174e2598dc8108ebb342
lichii-linux-aarch64-pgo.AppImageac00f4e855edc30f5974e2bd1959c970a61a01aee333510fa3525d0910c23465
lichii-linux-aarch64.AppImage011d246c736b7dd6419da4cb73d1e35883946742c25fc0455dfa18e8ea7e337b
lichii-linux-aarch64-pgo.tar.gz1dca77eb729b205b36e9093257797432875237f88f0e6f6cbf187e4d0a559994
lichii-linux-aarch64.tar.gz0fc2137f4f867dbc1f818f5a883dfc481a0c4b7ef0d6cb207d45fa3780a0418d
lichii-macos-arm64.dmgdadd5d979298ce53e9de856efda48d53c7189b405551dafb2f52283b025e0390
lichii-macos-arm64.zip916e96bd3a10509680e57870618348b7a75a7cad49f22e8359bef5a4c9376661

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:

ControllerGyro in Lichii (SDL3)Why pick itAmazon
Sony DualSenseYes (USB-C & Bluetooth)Confirmed working in Mario Kart World (#523); full SDL3 gyro on Windows, macOS & LinuxView on Amazon →
GameSir Cyclone 2Switch mode / PCTMR electromagnetic sticks (no drift) + Hall/micro-switch triggers for PC & Switch 2View on Amazon →
8BitDo Ultimate 2 BluetoothSwitch modeNintendo ABXY layout, TMR sticks and charging dock for Switch 2 & WindowsView on Amazon →
Xbox Wireless ControllerNo gyroPlug-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.

Advertisement
A heap of fresh lychees with their pink, bumpy shells, on a white ground
Lychees (Litchi chinensis).

Common questions

Is there a native Fritchii Linux AppImage or macOS build?

No. Every binary published on github.com/Frizti/Fritchii/releases (up through fritchii-v5.8.4) is a Windows x64 archive (Fritchii-v5.8.4-Windows-x64.zip). Fritchii v5.6 fixed compiling from source on Linux (Fritchii #19), while prebuilt releases remain Windows-only. For native Linux AppImage / tar.gz and macOS 15+ Apple Silicon packages, download mainline zortos293/Lichii (build 316) or CheezyEmu (build 12).

How do I run Fritchii on desktop Linux or Steam Deck?

Extract Fritchii-v5.8.4-Windows-x64.zip into a folder and run Fritchii-v5.8.4/lichii.exe through Steam’s Proton Experimental or GE-Proton (Games > Add a Non-Steam Game), or via Lutris / Bottles with a modern Wine-GE runner. Vulkan calls pass directly through winevulkan to Mesa RADV or NVIDIA’s Linux driver. Keep Graphics > Mesh Shaders on Automatic or Compute, and plug handhelds into wall power for the one-time ~15-minute 120,461-shader preparation.

Which Lichii file should I download for Linux x86_64 vs Linux ARM64?

On desktop PCs and x86 handhelds with glibc 2.39+ (Ubuntu 24.04+, Fedora 40+, Debian 13, Arch, CachyOS, SteamOS 3.6+), download lichii-linux-x86_64-pgo.AppImage (157.8 MB). On ARM64 Linux boards or laptops, download lichii-linux-aarch64-pgo.AppImage (137.8 MB). On minimal systems or containers without FUSE (libfuse2), pick the matching -pgo.tar.gz, extract it, and run lichii/lichii — since build 150 (#1255), both tar.gz archives bundle Qt 6.8.3, FFmpeg 7.1 and Wayland plugins.

Can I run Fritchii or Lichii on a Mac?

On a Mac with Apple Silicon (M1 / M2 / M3 / M4) running macOS 15 Sequoia or newer, use native lichii-macos-arm64.dmg (90.3 MB) or lichii-macos-arm64.zip (80.9 MB) from zortos293/Lichii build 316 (or cheezyemu-macos-arm64.dmg). Do not try to run Windows x64 Fritchii through CrossOver or Whisky: Switch 2 emulation relies heavily on AVX2/x86-64 JIT and Vulkan extensions that stall or fail under double x86-to-ARM + Wine/MoltenVK translation. Intel Macs are not supported.

Why does macOS block lichii.app on first launch, and where are Mac files stored?

Because open-source CI builds are not Apple-notarized, Gatekeeper blocks the first double-click. Right-click lichii.app in /Applications and choose Open, or run xattr -dr com.apple.quarantine /Applications/lichii.app in Terminal (build 316 uses bundle ID io.github.zortos293.lichii, #1544). On both Linux and macOS, Lichii follows XDG directories: keys and NAND firmware live in ~/.local/share/lichii/ and settings in ~/.config/lichii/ (see firmware & keys folder setup).

Does Linux or macOS Lichii include games, keys or firmware?

No. Every GitHub archive ships the GPL-3.0 emulator only. Supply your own legally obtained Switch / Switch 2 games, decryption keys and firmware; this site hosts no files and provides no download links for copyrighted material.