Repository navigation
Releases
Tuxchii v6.2 (Linux AppImage)
Linux changes in this build
These changes are made for Linux before compiling (all visible in the public build log and in linux-patches):
- NVIDIA DLSS on Linux (RTX cards): Settings → Graphics → Install DLSS... downloads NVIDIA's DLSS files (about 60 MB) from NVIDIA onto your PC, then the DLSS option and DLSS quality modes work as on Windows. NVIDIA's license doesn't allow shipping those files here, so they are never part of the AppImage (patch, bridge)
- Shader setup on a game's first launch: Tuxchii offers to pre-build all of the game's shaders before you play (much smoother, about 20 minutes or more). The game starts paused while they build and tells you when it's ready (patch)
- No GPU hang on AMD RX 7000/9000 with Mesa older than 26.2.5: works around a RADV bug that froze the GPU on mesh-shader draws (backport of zortos293/Lichii#1203; patch)
- Your shader cache comes along: v5.8 moved Fritchii's folders from
edentofritchiiand copies settings, saves and keys, but not caches. This build also copies each game's shader cache from~/.cache/eden(or Lichii's) to~/.cache/fritchiionce, so games don't start stuttering again (patch) - Full shader preparation: Fritchii's shader recipes (from its Windows release of the same version) are included, so the "Preparing shaders" screen builds all of a game's shaders (about 120,000 for Ocarina of Time) like on Windows
- Updates from this repo: Help → Check for Updates (and a check at startup) downloads the newest Tuxchii AppImage, checks its SHA-256, replaces this one and restarts; the old version is kept for Roll Back. It updates from this repo, so you stay on Tuxchii instead of being switched to Fritchii's own build (patch)
- Tuxchii name in every window and dialog. Data folders, settings and saves are unchanged, so nothing moves (script)
- Prepare Shaders on AMD and Intel (Steam Deck too): upstream only prepares shaders on NVIDIA; Mesa drivers (RADV, ANV, NVK) now get them as well, the classic interface shows the "Preparing shaders" screen, and a Steam Deck switches to handheld mode once (docked 1080p is too heavy for it) (patch)
- Classic interface by default, with a settings checkbox to switch (see below) (patch)
- Compile fixes for Windows-only code paths (X11
Statusmacro clash, LinuxGetExeDirectory(), a Windows-only log variable), applied only where needed
Tuxchii v6.2: a Linux x86_64 AppImage of Fritchii v6.2, built automatically on GitHub from upstream commit 16396c8.
⚠️ Unofficial build, not Frizti's. Fritchii also has its own Linux AppImage; this one is built on an older base, so it runs on more distros (it needs glibc 2.38, see Requirements), and it has the Linux changes above. Report problems with this build here, not upstream.
Classic interface by default
This build opens in the classic interface, mainly so it works well with SteamOS / Steam Big Picture mode. It also follows your desktop theme, font size and scaling like any other Qt app, which Fritchii's own dark interface (Graphite theme, Inter font, home screen) doesn't.
To use Fritchii's dark interface instead:
- Settings → UI → General → "Use the Tuxchii interface (restart required)", then restart Tuxchii. Untick it the same way to go back.
- Or for a single launch, set
FRITCHII_CLASSIC_UI=0(forces the dark interface) orFRITCHII_CLASSIC_UI=1(forces the classic one).
Emulation, performance and shader features are identical in both; only the interface changes.
Download
Tuxchii-v6.2-x86_64.AppImage
SHA-256: 6a50632081c03cb7204886da1d51e92867263e5b0c66b19d341f3d8a6998b192
Already have Tuxchii? It updates itself: Help → Check for Updates (it also checks when it starts). Gear Lever, AppImageUpdate and AppImageLauncher can update it too.
Run it
chmod +x Tuxchii-v6.2-x86_64.AppImage
./Tuxchii-v6.2-x86_64.AppImageIf it complains about FUSE, run it with --appimage-extract-and-run.
Requirements
- x86_64 Linux with glibc 2.38 or newer (Debian 13, Ubuntu 24.04, Fedora 40, current Arch/SteamOS or newer)
- A GPU with a working Vulkan driver
NVIDIA tip: the driver trims its shader cache at about 1 GB by default, which can bring back stutter. Add these two lines to /etc/environment and reboot:
__GL_SHADER_DISK_CACHE_SIZE=10737418240
__GL_SHADER_DISK_CACHE_SKIP_CLEANUP=1
What's new in Fritchii v6.2
From Frizti's release notes (Windows download instructions left out).
Fritchii v6.2: smaller graphics cards, slower PCs and above 60 fps.
Good to know
- Intel 12th to 14th gen (P-cores and E-cores): you shouldn't need
EDEN_HYBRID_CORES=0any more. v6.1 tied the GPU threads tightly to the P-cores, which halved fps on some of these CPUs. v6.2 lets Windows place them by default. If you added it, Fritchii turns it off for you on the first start (the line stays in Tools > Switches as a comment). If fps is still about half of what you expect, remove the # in front of it and tell us on the Discord. - First start asks once: "Use the recommended settings?" Use recommended applies the settings tuned for OoT and saves your old ones first. Keep my settings changes nothing. You can switch later in Settings > General.
- No new shader preparation: v6.2 keeps v6.1's prepared shaders.
Graphics cards with 4 to 6 GB
- No more texture churn when video memory runs short. On small cards Fritchii kept deleting textures the game was about to use again and making them over, dozens of times a frame. Now it keeps the ones the game keeps coming back to. On a simulated 4 GB card in Castle Town: 43 → 75 fps, 1% lows 20 → 57. A real 4 GB card also has to swap memory over PCIe, so expect less than that, but a big step either way.
- Less video memory lost to half-empty buffer blocks on small cards.
Picture
- The OoT Picture menu sets the render size and the upscaled output separately, so you can draw at 720p and let DLSS or FSR bring it up to 1080p or more.
- DLSS has an Automatic model, now the default. It uses K, the tested one, and the status bar shows the model actually in use.
Loading and busy areas
- Area loads unpack the game's files natively instead of through the emulated CPU, so loading screens should be a bit shorter.
- The game no longer starts tidying its texture memory every frame, only once a second. Every texture it moved used to be set up again by Fritchii.
AMD
- New setting: OoT occlusion speed-up (Graphics > Advanced). On AMD cards OoT's visibility checks are answered without the slow GPU queries: about +9% fps in the market on an RX 9070 XT. Standard is on by default. AMD players get a one-time offer of Full, which goes further. NVIDIA and Intel already use another fast path, so nothing changes there.
Intel CPUs
- CPU settings > Intel P-cores: on Intel CPUs with P-cores and E-cores, try the pinned choice and tell us on the Discord whether it helps your PC.
Above 60 fps (High refresh rate)
- The time of day no longer slows down or freezes above 60 fps.
- Epona jumps fences instead of galloping through them.
- A song's notes show one at a time with the music.
- The Deku Tree's web reacts when Link lands on it, and moving platforms carry Link.
Below 60 fps
- Link's cap and other cloth settle as they should when the game runs slow, instead of flaring out for a second.
Stability
- When Windows runs out of memory for a moment, Fritchii waits and tries again instead of closing.
- A crash report now names the GPU work that hung, and a few rare GPU limits no longer end the game.
Some fixes in this release are ports from the Longshot and HeyListen projects, with thanks.
Notes
- Games, keys and firmware are not included. Only use files you've legally dumped yourself.
- Thanks to Frizti, zortos293 and the Lichii/Eden/yuzu contributors.
Tuxchii v6.1 (Linux AppImage)
Linux changes in this build
These changes are made for Linux before compiling (all visible in the public build log and in linux-patches):
- NVIDIA DLSS on Linux (RTX cards): Settings → Graphics → Install DLSS... downloads NVIDIA's DLSS files (about 60 MB) from NVIDIA onto your PC, then the DLSS option and DLSS quality modes work as on Windows. NVIDIA's license doesn't allow shipping those files here, so they are never part of the AppImage (patch, bridge)
- Shader setup on a game's first launch: Tuxchii offers to pre-build all of the game's shaders before you play (much smoother, about 20 minutes or more). The game starts paused while they build and tells you when it's ready (patch)
- No GPU hang on AMD RX 7000/9000 with Mesa older than 26.2.5: works around a RADV bug that froze the GPU on mesh-shader draws (backport of zortos293/Lichii#1203; patch)
- Your shader cache comes along: v5.8 moved Fritchii's folders from
edentofritchiiand copies settings, saves and keys, but not caches. This build also copies each game's shader cache from~/.cache/eden(or Lichii's) to~/.cache/fritchiionce, so games don't start stuttering again (patch) - Full shader preparation: Fritchii's shader recipes (from its Windows release of the same version) are included, so the "Preparing shaders" screen builds all of a game's shaders (about 120,000 for Ocarina of Time) like on Windows
- Updates from this repo: Help → Check for Updates (and a check at startup) downloads the newest Tuxchii AppImage, checks its SHA-256, replaces this one and restarts; the old version is kept for Roll Back. It updates from this repo, so you stay on Tuxchii instead of being switched to Fritchii's own build (patch)
- Tuxchii name in every window and dialog. Data folders, settings and saves are unchanged, so nothing moves (script)
- Prepare Shaders on AMD and Intel (Steam Deck too): upstream only prepares shaders on NVIDIA; Mesa drivers (RADV, ANV, NVK) now get them as well, the classic interface shows the "Preparing shaders" screen, and a Steam Deck switches to handheld mode once (docked 1080p is too heavy for it) (patch)
- Classic interface by default, with a settings checkbox to switch (see below) (patch)
- Compile fixes for Windows-only code paths (X11
Statusmacro clash, LinuxGetExeDirectory(), a Windows-only log variable), applied only where needed
Tuxchii v6.1: a Linux x86_64 AppImage of Fritchii v6.1, built automatically on GitHub from upstream commit e0f673a.
⚠️ Unofficial build, not Frizti's. Fritchii also has its own Linux AppImage; this one is built on an older base, so it runs on more distros (it needs glibc 2.38, see Requirements), and it has the Linux changes above. Report problems with this build here, not upstream.
Classic interface by default
This build opens in the classic interface, mainly so it works well with SteamOS / Steam Big Picture mode. It also follows your desktop theme, font size and scaling like any other Qt app, which Fritchii's own dark interface (Graphite theme, Inter font, home screen) doesn't.
To use Fritchii's dark interface instead:
- Settings → UI → General → "Use the Tuxchii interface (restart required)", then restart Tuxchii. Untick it the same way to go back.
- Or for a single launch, set
FRITCHII_CLASSIC_UI=0(forces the dark interface) orFRITCHII_CLASSIC_UI=1(forces the classic one).
Emulation, performance and shader features are identical in both; only the interface changes.
Download
Tuxchii-v6.1-x86_64.AppImage
SHA-256: 4025e2fba68d9805337638e34eede3771e3800f9dd83e452d177e05b19184999
Already have Tuxchii? It updates itself: Help → Check for Updates (it also checks when it starts). Gear Lever, AppImageUpdate and AppImageLauncher can update it too.
Run it
chmod +x Tuxchii-v6.1-x86_64.AppImage
./Tuxchii-v6.1-x86_64.AppImageIf it complains about FUSE, run it with --appimage-extract-and-run.
Requirements
- x86_64 Linux with glibc 2.38 or newer (Debian 13, Ubuntu 24.04, Fedora 40, current Arch/SteamOS or newer)
- A GPU with a working Vulkan driver
NVIDIA tip: the driver trims its shader cache at about 1 GB by default, which can bring back stutter. Add these two lines to /etc/environment and reboot:
__GL_SHADER_DISK_CACHE_SIZE=10737418240
__GL_SHADER_DISK_CACHE_SKIP_CLEANUP=1
What's new in Fritchii v6.1
From Frizti's release notes (Windows download instructions left out).
Fritchii v6.1: the pot room fix.
Pot room
- Walking around the pot room (Castle Town guard house) no longer eats VRAM. Moving there made thousands of new shadow images every few seconds and video memory climbed by about 4 GB. A fix for it existed before v6.0 but didn't make it into the release. It's built in now.
- On our test PC (strafing in the pot room, uncapped): 67 → 71 fps, 1% lows 46 → 48, video memory 10.5 → 7.4 GB.
Linux
- The v6.0 Linux files were built a few hours before the final Windows build, so they missed the last v6.0 fixes and still said "v6.0 Beta". v6.1 on Linux has everything. Fritchii's tuned settings are applied once on Linux with this update.
Nothing else changes: your settings stay as they are on Windows, and no new shader preparation is needed.
Notes
- Games, keys and firmware are not included. Only use files you've legally dumped yourself.
- Thanks to Frizti, zortos293 and the Lichii/Eden/yuzu contributors.
Tuxchii v5.8.4 (Linux AppImage)
- NVIDIA DLSS on Linux (RTX cards): Settings → Graphics → Install DLSS... downloads NVIDIA's DLSS files (about 60 MB) onto the PC; NVIDIA's files are never in the AppImage (zz-nvidia-dlss-linux.patch, dlss-bridge).
- Shader setup on a game's first launch: offers to pre-build all of the game's shaders before playing (shader-setup-prompt.patch).
- Shader cache comes along: copies each game's shader cache from
~/.cache/eden(or Lichii's) to~/.cache/fritchiionce (shader-cache-import.patch). - Full shader preparation: Fritchii's shader recipes from its Windows release of the same version are included (about 120,000 shaders for Ocarina of Time).
- Built like Fritchii's own Linux build: Clang with Fritchii's PGO profile; C++ runtime and Vulkan loader from the system.
- Updates from the repo: Help → Check for Updates downloads the newest AppImage, checks its SHA-256, replaces it and keeps the old one for Roll Back (tuxchii-updater.patch).
- Tuxchii name in every window and dialog; data folders, settings and saves unchanged (tuxchii-branding.py).
- Prepare Shaders on AMD and Intel (Steam Deck too), plus Steam Deck handheld mode (steam-deck-test.patch).
- Classic interface by default, with Settings → UI → General → "Use the Tuxchii interface" or
FRITCHII_CLASSIC_UI=0/1to switch (classic-ui-setting.patch). - Compile fixes for Windows-only code paths (X11
Statusmacro, LinuxGetExeDirectory(), a Windows-only log variable).
Requirements: x86_64 Linux with glibc 2.39+, a working Vulkan driver. NVIDIA tip: __GL_SHADER_DISK_CACHE_SIZE=10737418240 and __GL_SHADER_DISK_CACHE_SKIP_CLEANUP=1 in /etc/environment.
Fritchii v5.8.4's own changes (from Frizti's notes): saves copied with the Saves button now go into Fritchii's own user; the Saves window always backs up first; a Fix button for misplaced saves; Switch 2 games always use the 12 GB memory layout while running; per-game DLSS quality and preset.
SHA-256 of Tuxchii-v5.8.4-x86_64.AppImage: 34572f83211aaee499d9f57d3e7c6e0a0b2eb8172d7b22ce306ca34f46d9058d