Fritchii & Lichii on Linux & Steam Deck

Frizti/Fritchii only publishes Windows x64 .zip builds (Fritchii-v5.8.4-Windows-x64.zip) – there is no native Linux AppImage for Fritchii, whereas mainline zortos293/Lichii (build 316) and MythosOfs/Orchid (v0.10.0) ship native Linux x86_64.AppImage packages and self-contained FUSE-free linux-x86_64.tar.gz archives. On SteamOS and desktop Linux you have two clear paths: run Fritchii’s Windows build under Proton Experimental / GE-Proton for Ocarina of Time’s 120,461-shader pre-compilation, or run native Linux Lichii and Orchid directly on Wayland and Mesa RADV. Checked on November 17, 2026.

Advertisement

Lichii Emulator Guide / Linux & Steam Deck

Nintendo Switch 2 Joy-Con controllers in their grip beside the empty dock

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:

Advertisement
FeatureFritchii via Proton (Fritchii v5.8.4)Native Lichii (build 316)Native Orchid (v0.10.0)
RepositoryFrizti/Fritchiizortos293/LichiiMythosOfs/Orchid
Linux packageNone (run Fritchii-v5.8.4-Windows-x64.zip via Steam Proton)x86_64-pgo.AppImage & FUSE-free self-contained tar.gzlinux-x86_64-pgo.AppImage & system-Qt tar.gz
Target gamesOcarina of Time (0400486024DEC000) onlyOcarina of Time, Mario Kart World, Yoshi, Star Fox & moreMario Tennis Fever, Hyrule Warriors, Xenoblade, Wonder, Pokopia
Shader compilationPre-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 notesv5.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 #871Tested 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 foldercompatdata/<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 / LinuxPlayers wanting Fritchii’s Ocarina-only presets, Saves manager and 120,461-shader pre-buildMainline Switch 2 desktop/Deck play without Proton prefixes, including FUSE-free distrosAMD 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:

  1. Switch your Steam Deck to Desktop Mode (Power menu > Switch to Desktop), download Fritchii-v5.8.4-Windows-x64.zip from Frizti/Fritchii on GitHub, and extract the entire Fritchii-v5.8.4 folder (for example into ~/Applications/Fritchii-v5.8.4/).
  2. Inside Fritchii-v5.8.4/, look for lichii.exe. Searches and guides often refer to Fritchii.exe, yet Frizti’s Windows archive still names the binary lichii.exe alongside vc_redist.x64.exe.
  3. 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.
  4. 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.exe once, install it, then switch Target back to lichii.exe.)
  5. 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.
  6. 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 #814 without 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.4 path 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 in nand\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):

ReleaseFile namePackage typeSizeBytesLink
Lichii build 316lichii-linux-x86_64-pgo.AppImageAppImage, PGO (recommended)157.8 MB157,764,088GitHub download
Lichii build 316lichii-linux-x86_64.AppImageAppImage, standard128.5 MB128,543,224GitHub download
Lichii build 316lichii-linux-x86_64-pgo.tar.gztar.gz, PGO (recommended)169.4 MB169,440,465GitHub download
Lichii build 316lichii-linux-x86_64.tar.gztar.gz, standard138.2 MB138,225,656GitHub download
Lichii build 316lichii-linux-aarch64-pgo.AppImageAppImage, PGO (recommended)137.8 MB137,751,048GitHub download
Orchid v0.10.0orchid-v0.10.0-linux-x86_64-pgo.AppImageAppImage139.0 MB139,049,464GitHub download
Orchid v0.10.0orchid-v0.10.0-linux-x86_64.AppImageAppImage110.0 MB110,045,688GitHub download
Orchid v0.10.0orchid-v0.10.0-linux-x86_64-pgo.tar.gztar.gz (system Qt 6)25.8 MB25,814,874GitHub download
Orchid v0.10.0orchid-v0.10.0-linux-x86_64.tar.gztar.gz (system Qt 6)31.7 MB31,701,727GitHub download
  • AppImage (recommended on SteamOS & desktop distros): run chmod +x lichii-linux-x86_64-pgo.AppImage (or orchid-v0.10.0-linux-x86_64-pgo.AppImage) and execute it directly, or add the .AppImage as 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 without libfuse2, extract lichii-linux-x86_64-pgo.tar.gz and run lichii/lichii. Unlike Orchid’s tar.gz (which links against system Qt 6), Lichii’s tar.gz is packed straight from the AppImage AppDir with 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), and MADV_COLD guest 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:

FileSHA-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
orchid-v0.10.0-linux-x86_64-pgo.AppImageafaca2a3b72e4a38c6e0119883bf0ae359ed1a9d7c8335b98f6c2feac1e7c841
orchid-v0.10.0-linux-x86_64.AppImage8c3914de31729a8b5798681c528983de37fbb75031452ef94da1b49a4b19448f
orchid-v0.10.0-linux-x86_64-pgo.tar.gz8b0a836abd5e26cee3216a769ed56d1149557503c8eeef1f750b6faa9acff24b
orchid-v0.10.0-linux-x86_64.tar.gzeb29021748a15df04cf4c1bcf95bd0496250c0220c59538996c52eb52d02ee14

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 .nx archives (builds 130–160): Vulkan Shader Cache v2 (#1036, #1076) skips pipeline builds that previously crashed Linux drivers; single-file compressed .nx archives load natively (#923, #1078) with nxformat 1.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-vk FSR 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 / amdgpu GPU 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 0 as Player 1 inside Emulation > 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 hidraw permissions: if a controller is invisible on Ubuntu, Fedora or Arch, install dist/72-eden-input.rules into /etc/udev/rules.d/ and reload udevadm:
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:

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

Does Fritchii have a native Linux AppImage or Steam Deck build?

No. Every binary published on github.com/Frizti/Fritchii/releases (including fritchii-v5.8.4) is a Windows x64 .zip archive (Fritchii-v5.8.4-Windows-x64.zip). Fritchii v5.6 fixed compiling from source on Linux (Fritchii #19), so prebuilt binaries remain Windows-only. For a native Linux AppImage or FUSE-free tar.gz, download mainline zortos293/Lichii (build 316) or MythosOfs/Orchid (v0.10.0).

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

Extract Fritchii-v5.8.4-Windows-x64.zip into a folder, switch SteamOS to Desktop Mode, open Steam > Games > Add a Non-Steam Game, and add Fritchii-v5.8.4/lichii.exe (the executable inside the Fritchii archive is named lichii.exe, even though many guides call it Fritchii.exe). In the shortcut’s Properties > Compatibility, force Proton Experimental or GE-Proton, keep the Steam Deck plugged into AC power during the one-time ~15-minute 120,461-shader build, and keep Graphics > Mesh Shaders on Automatic or Compute.

Should I download the Lichii AppImage or the tar.gz on Linux?

On SteamOS, Ubuntu 24.04, Fedora 40, Debian 13, Arch and CachyOS (all with glibc 2.39+), pick lichii-linux-x86_64-pgo.AppImage (157.8 MB), run chmod +x, and launch it. On containers or distributions without FUSE (libfuse2), pick lichii-linux-x86_64-pgo.tar.gz (169.4 MB), extract it, and run lichii/lichii – since build 150 (#1255), Lichii builds the tar.gz directly from the AppImage AppDir so Qt 6.8.3, FFmpeg 7.1 and Wayland plugins are bundled.

Where does Proton store Fritchii saves, and how do I fix Orphaned Profiles?

Steam creates a separate Wine prefix per Non-Steam shortcut at ~/.local/share/Steam/steamapps/compatdata/<AppID>/pfx/drive_c/users/steamuser/AppData/Roaming/fritchii/. Use the Saves button on Fritchii’s home screen (Help > Saves..., added in v5.8.3) to export or import saves as a .zip. If imported or copied saves show “Orphaned Profiles Detected” or do not appear in Ocarina of Time, open Saves and press Fix (v5.8.4), which backs up nand\user\save-backups first and moves the saves into Fritchii’s active user profile.

Which runs better on SteamOS and AMD RADV: Proton Fritchii, Lichii or Orchid?

Use Proton Fritchii only when you specifically want its upfront 120,461-shader pre-compilation for Ocarina of Time (converted for AMD drivers in v5.4). For broader Switch 2 games on SteamOS and desktop Mesa RADV, use native Orchid v0.10.0 (benchmarked by its author on CachyOS + Mesa RADV with dedicated RADV depth-compare and BC3 fixes) or native Lichii build 316 (Wayland + PipeWire audio fix #850 + Shader Cache v2 #1036 + 55–75 ms SPIR-V pipeline rebuilds #1334/#1337).

Do Linux or Steam Deck builds include games, keys or firmware?

No. All GitHub archives contain the open-source GPL-3.0 emulator only. You must supply your own legally obtained games, keys and firmware; this site hosts no files and does not link to or explain how to obtain them.