Emulator downloads only. None of these GitHub repositories include games, keys or Switch 2 firmware, and this guide does not link to or explain how to obtain them.
AppImage vs Proton overview
All three emulators share the Eden / Eglantine C++20 Vulkan codebase under GPL-3.0, yet package Linux and AMD RADV support differently:
| Feature | Fritchii via Proton (Fritchii v5.8.4) | Native Lichii (build 316) | Native Orchid (v0.10.0) |
|---|---|---|---|
| Repository | Frizti/Fritchii | zortos293/Lichii | MythosOfs/Orchid |
| Linux package | None (run Fritchii-v5.8.4-Windows-x64.zip via Steam Proton) | x86_64-pgo.AppImage & FUSE-free self-contained tar.gz | linux-x86_64-pgo.AppImage & system-Qt tar.gz |
| Target games | Ocarina of Time (0400486024DEC000) only | Ocarina of Time, Mario Kart World, Yoshi, Star Fox & more | Mario Tennis Fever, Hyrule Warriors, Xenoblade, Wonder, Pokopia |
| Shader compilation | Pre-compiles all 120,461 shaders once before play (converted for AMD in v5.4) | Shader Cache v2 (#1036) + RAM SPIR-V rebuild cutting revisit hitches to 55–75 ms (#1334, #1337) | Disk shader cache + lower IR compile RAM (0.9.3) |
| SteamOS / RADV notes | v5.6 compute fallback for AMD mesh-shader hangs (#814); DXVK/Wine layer not used (direct Vulkan via winevulkan) | Qt 6.8.3 + FFmpeg 7.1 + Wayland + GameMode; PipeWire Deck audio fix (#850); AMD FSR 3.1/4 (#1060); open AMD issue #871 | Tested on CachyOS + Mesa RADV (RX 9070 XT); RADV BC3 (0.5.1), depth-compare (0.7.2) & host Vulkan loader for MangoHud (0.9.1) |
| Data & save folder | compatdata/<AppID>/pfx/.../Roaming/fritchii + built-in Saves > Fix tool | ~/.local/share/lichii (since build 150, #1253, with safe Eden import) | ~/.local/share/eden / XDG data folders |
| Best fit on Deck / Linux | Players wanting Fritchii’s Ocarina-only presets, Saves manager and 120,461-shader pre-build | Mainline Switch 2 desktop/Deck play without Proton prefixes, including FUSE-free distros | AMD Radeon / SteamOS RADV players running Mario Tennis Fever, Hyrule Warriors or Wonder |
A fourth option for AMD handhelds and Linux desktops is CheezyEmu (CheezerWheezer/CheezyEmu, cheezyemu-linux-x86_64-pgo.AppImage): build 10 added a Steam Deck / ROG Ally anti-aliasing bypass, build 11 enabled automatic Linux RADV mesh-shader compute fallback, and build 12 adds native Linux FSR 3.1 upscaling, 2x FSR Frame Generation, a built-in 116,570-pipeline Ocarina of Time shader recipe, and SteamOS AppImage updater TLS certificates.
Fritchii via Steam Deck Proton
Because Fritchii ships Windows x64 zips only (Fritchii-v5.8.4-Windows-x64.zip, 72.6 MB), running it on SteamOS or a Linux PC means wrapping its Windows executable inside Steam’s Proton compatibility layer so Vulkan calls pass straight through winevulkan to Mesa RADV:
- Switch your Steam Deck to Desktop Mode (Power menu > Switch to Desktop), download
Fritchii-v5.8.4-Windows-x64.zipfromFrizti/Fritchiion GitHub, and extract the entireFritchii-v5.8.4folder (for example into~/Applications/Fritchii-v5.8.4/). - Inside
Fritchii-v5.8.4/, look forlichii.exe. Searches and guides often refer toFritchii.exe, yet Frizti’s Windows archive still names the binarylichii.exealongsidevc_redist.x64.exe. - Open the desktop Steam client, click Games > Add a Non-Steam Game to My Library, click Browse..., set the file filter to All Files, and select
Fritchii-v5.8.4/lichii.exe. - Right-click the new library entry > Properties > Compatibility, tick Force the use of a specific Steam Play compatibility tool, and select Proton Experimental or GE-Proton. (If Windows runtime DLLs are missing inside a fresh prefix, temporarily point the shortcut’s Target to
vc_redist.x64.exeonce, install it, then switch Target back tolichii.exe.) - Plug the Steam Deck into AC wall power before first launch: Fritchii prepares all 120,461 Ocarina of Time shaders upfront. That takes roughly 15 minutes on an 8-core desktop Ryzen 7800X3D and longer on the Steam Deck’s 4-core / 8-thread Zen 2 APU, cutting later area-entry hitches from ~0.7 s down to 40–70 ms. Since v5.8, subsequent Fritchii updates do not repeat this step unless shader translation changed.
- Check your AMD RADV graphics settings (full breakdown in Fritchii best settings): Fritchii v5.4 converts all 120,461 NVIDIA-recorded shaders for AMD drivers instead of skipping 116,373 of them, and v5.6 adds
Graphics > Mesh Shaders(keep it on Automatic or Compute so AMD / RADV mesh draws use the compute fallback from#814without hanging the GPU). Leave Extended Dynamic State on EDS2 (restored in v5.5).
Proton save path and Fix tool
Every Non-Steam shortcut gets its own numeric <AppID> folder under Steam’s compatdata directory. Inside Proton, Fritchii v5.8+ writes your saves, shader cache and settings to:
~/.local/share/Steam/steamapps/compatdata/<AppID>/pfx/drive_c/users/steamuser/AppData/Roaming/fritchii/
- Updating without losing your Proton prefix: let Fritchii’s built-in startup updater install new versions in place (it verifies GitHub’s SHA-256 and retries dropped connections since v5.3), or overwrite files inside the same
Fritchii-v5.8.4path rather than creating a second Non-Steam shortcut with a new empty<AppID>. - Moving saves between native Linux Lichii and Proton Fritchii: click Saves on Fritchii’s home screen (
Help > Saves..., added in v5.8.3) to export or import saves as a portable.zip, with automatic backups stored innand\user\save-backups. - Fixing “Orphaned Profiles Detected”: if saves copied from Eden or Lichii 150+ landed under another emulator’s user ID and do not show up in Ocarina of Time, open Saves and click the Fix button (added in v5.8.4). Fritchii backs up the folder first and moves those saves into Fritchii’s own user profile.
Native Linux Lichii and Orchid
If you prefer zero Wine/Proton overhead, native Wayland/X11 windows, and support for Switch 2 titles beyond Ocarina of Time, both zortos293/Lichii (build 316) and MythosOfs/Orchid (v0.10.0) publish native Linux builds compiled against glibc 2.39+ (SteamOS 3.6+, Ubuntu 24.04, Fedora 40, Debian 13, Arch, CachyOS):
| Release | File name | Package type | Size | Bytes | Link |
|---|---|---|---|---|---|
| Lichii build 316 | lichii-linux-x86_64-pgo.AppImage | AppImage, PGO (recommended) | 157.8 MB | 157,764,088 | GitHub download |
| Lichii build 316 | lichii-linux-x86_64.AppImage | AppImage, standard | 128.5 MB | 128,543,224 | GitHub download |
| Lichii build 316 | lichii-linux-x86_64-pgo.tar.gz | tar.gz, PGO (recommended) | 169.4 MB | 169,440,465 | GitHub download |
| Lichii build 316 | lichii-linux-x86_64.tar.gz | tar.gz, standard | 138.2 MB | 138,225,656 | GitHub download |
| Lichii build 316 | lichii-linux-aarch64-pgo.AppImage | AppImage, PGO (recommended) | 137.8 MB | 137,751,048 | GitHub download |
| Orchid v0.10.0 | orchid-v0.10.0-linux-x86_64-pgo.AppImage | AppImage | 139.0 MB | 139,049,464 | GitHub download |
| Orchid v0.10.0 | orchid-v0.10.0-linux-x86_64.AppImage | AppImage | 110.0 MB | 110,045,688 | GitHub download |
| Orchid v0.10.0 | orchid-v0.10.0-linux-x86_64-pgo.tar.gz | tar.gz (system Qt 6) | 25.8 MB | 25,814,874 | GitHub download |
| Orchid v0.10.0 | orchid-v0.10.0-linux-x86_64.tar.gz | tar.gz (system Qt 6) | 31.7 MB | 31,701,727 | GitHub download |
- AppImage (recommended on SteamOS & desktop distros): run
chmod +x lichii-linux-x86_64-pgo.AppImage(ororchid-v0.10.0-linux-x86_64-pgo.AppImage) and execute it directly, or add the.AppImageas a Non-Steam Game in Desktop Mode without forcing Proton. Since Lichii build 116 (#509), Lichii’s built-in updater updates the AppImage in place and keeps one rollback copy. - FUSE-free self-contained
tar.gz(Lichii build 150+, #1255): on systems or containers withoutlibfuse2, extractlichii-linux-x86_64-pgo.tar.gzand runlichii/lichii. Unlike Orchid’star.gz(which links against system Qt 6), Lichii’star.gzis packed straight from the AppImageAppDirwith every library bundled. - Bundled Linux stack in Lichii CI (
release-binaries.yml): compiled with Clang PGO (trained on Eglantine’s profile), Qt 6.8.3, bundled FFmpeg 7.1 libraries, Wayland plugins (libqwayland-egl.so,libqwayland-generic.so), Feral GameMode support (gamemode), andMADV_COLDguest memory paging (#756).
Linux SHA-256 checksums
Verify any downloaded AppImage or archive in Konsole or your terminal with sha256sum <file> before marking it executable:
| File | 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 |
orchid-v0.10.0-linux-x86_64-pgo.AppImage | afaca2a3b72e4a38c6e0119883bf0ae359ed1a9d7c8335b98f6c2feac1e7c841 |
orchid-v0.10.0-linux-x86_64.AppImage | 8c3914de31729a8b5798681c528983de37fbb75031452ef94da1b49a4b19448f |
orchid-v0.10.0-linux-x86_64-pgo.tar.gz | 8b0a836abd5e26cee3216a769ed56d1149557503c8eeef1f750b6faa9acff24b |
orchid-v0.10.0-linux-x86_64.tar.gz | eb29021748a15df04cf4c1bcf95bd0496250c0220c59538996c52eb52d02ee14 |
SteamOS RADV and shader fixes
- 55–75 ms SPIR-V pipeline rebuilds (Lichii build 160, #1334 & #1337): Lichii retains compiled pipelines up to a RAM ceiling and keeps SPIR-V in memory so evicted pipelines rebuild in roughly 55–75 ms instead of 360–770 ms when revisiting an area, with an optional boot-time build of all cached shaders.
- Shader Cache v2 & built-in
.nxarchives (builds 130–160): Vulkan Shader Cache v2 (#1036, #1076) skips pipeline builds that previously crashed Linux drivers; single-file compressed.nxarchives load natively (#923, #1078) withnxformat1.0.3 linked directly into the binary (#1232). - PipeWire / Steam Deck audio & Linux FSR 4.1.1 (builds 150–316): build 150 fixed audio dropouts under PipeWire on Linux and Steam Deck (#850) and added AMD FSR 3.1 / FSR 4 upscaling for Ocarina of Time (#1060); build 160 permits AMD device memory overallocation (#1335); and build 316 packages optional community
fsr4-vkFSR 4.1.1 on Linux x86-64 RDNA 2+ RADV (#1496). - Orchid’s Mesa RADV track record: Orchid’s compatibility table was measured on Linux with Mesa RADV (Ryzen 7 5800X3D + RX 9070 XT on CachyOS), shipping fixes for RADV BC3 texture flashing (0.5.1), a RADV depth-compare boot crash (0.7.2), AMD demote reordering (0.7.5), and host Vulkan loader pass-through in the AppImage so SteamOS MangoHud works out of the box (0.9.1).
- Known open Linux / RADV tracker issues: on
zortos293/Lichii, open tracking issue #871 follows AMD Vulkan device-loss /amdgpuGPU resets at the Ocarina of Time intro-to-3D handover or save load, and open issue #316 tracks missing RADV mesh-shader geometry on Linux when compute fallback is not engaged. Ensure your Steam Deck has adequate swap / ZRAM for 12 GB Switch 2 titles (see system requirements).
Steam Deck controls and udev
- Steam Deck Desktop Mode vs Gaming Mode: in Desktop Mode, keep the Steam client running in the background and select
Steam Virtual Gamepad 0as Player 1 insideEmulation > Configure... > Controls. In Gaming Mode, launch the shortcut normally so Steam Input maps the Deck’s built-in controls and gyro via SDL3. - External controller gyro on Steam Deck: the Deck and a Bluetooth gamepad compete for slot 0 on wake. To give an external DualSense gyro on Player 1, wake the Deck without pressing its buttons and turn the external pad on first (full walkthrough in controller setup).
- Desktop Linux
hidrawpermissions: if a controller is invisible on Ubuntu, Fedora or Arch, installdist/72-eden-input.rulesinto/etc/udev/rules.d/and reloadudevadm:
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ENV{ID_INPUT_JOYSTICK}=="1", MODE="0660", TAG+="uaccess"
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.

