Triforce Recomp

Linux AppImage and Steam Deck status

Triforce ships an experimental x86-64 Linux test build (Triforce-v0.3.6-linux-test-x86_64.AppImage, 231.53 MiB) tested on Wayland desktops alongside RDNA 2 task+mesh compute fallbacks for AMD GPUs and handhelds.

Verify Linux AppImage hash Check GPU driver table
glibc 2.35+Ubuntu 22.04+ / Arch / Fedora
48-60 fpsTested Wayland RTX 4070 Ti run
HDR10Wayland color-management v1
HP Dev One laptop running Fedora Linux GNOME Wayland
Upstream tested configurations include Ubuntu 26.04 and Arch Linux KDE Plasma 6.6 Wayland sessions.

Verified Linux desktop test runs

Upstream docs/tested-configurations.md records native Linux sessions without Wine overhead, including Wayland HDR10 swapchain negotiation.

Wayland + NVIDIA 595

Ubuntu 26.04 & Arch KDE Plasma

Tested on an AMD Ryzen 7 5800X (32 GB RAM) paired with an NVIDIA GeForce RTX 4070 Ti (driver 595.58.03) across Ubuntu 26.04 Wayland and Arch Linux KDE Plasma 6.6.4 Wayland. Delivers 48-60 fps across Kokiri Forest, Great Deku Tree, and Hyrule Field with native VK_EXT_swapchain_colorspace HDR10 output.

AppImage quick start

Permissions, saves, and Handheld profile

chmod +x Triforce-v0.3.6-linux-test-x86_64.AppImage
sha256sum Triforce-v0.3.6-linux-test-x86_64.AppImage
# Expect: 2934220f19784c7dbc604da6d09045c3bdeed253c3472cbe3308c40255510084
./Triforce-v0.3.6-linux-test-x86_64.AppImage

Linux saves default to ~/.local/share/hookshot/save/<user id>/ (or user/save/ next to the binary in portable setups).

Steam Deck (RDNA 2 Van Gogh) & Proton notes

SteamOS uses an AMD RDNA 2 APU with 16 GB unified memory shared between CPU and VRAM. Keep these engineering constraints in mind before building for Steam Deck or Linux handhelds:

  • Compile on a desktop PC first: Do not run the 40-minute ~60 GB initial AOT compilation on a handheld SD card. Build the game folder on a desktop workstation and copy the finished directory over LAN or NVMe.
  • Enable Minimum (4 GB) + Handheld profile: Set quality_preset = 1 and handheld_profile = 1 in triforce_options.ini (requires restart) so Triforce trims its VRAM pool and switches to Switch 2 handheld rendering parameters.
  • RADV mesh-shader & fallback flags: Triforce relies on Vulkan 1.3 + VK_EXT_mesh_shader. On Mesa RADV or RDNA 2 chips where specific mesh culling shaders misbehave, upstream documents RX_VK_TASK_MESH_FALLBACK=1 (compute task+mesh fallback) and RX_VK_MESH_NOCULL=2c56dc1006942f74 in triforce_env.txt.
  • Native AppImage vs Proton vs NX2navi v0.10.1: Windows Triforce.exe can also run under GE-Proton / Wine on SteamOS, or you can compare performance against the archival NX2navi v0.10.1 Linux AppImage and manage launches via RecompLauncher.
Close-up of wireless gamepad thumbstick and face buttons
SDL gamepad input maps Steam Deck controls and external Bluetooth controllers automatically; toggle A/B swap in Controls if needed.

Controllers tested with SDL presets

Triforce maps Xbox, PlayStation, and Switch-layout controllers natively in Controls and supports background input.

8BitDo Ultimate 2C Wireless Controller

Hall-effect sticks and triggers with low-latency 2.4G dongle for Windows and Linux SDL input.

Check on Amazon

GameSir Super Nova Hall-Effect Gamepad

Drift-resistant Hall sensors, swappable ABXY layout, and quiet membrane face buttons for Ocarina melodies.

Check on Amazon

8BitDo Pro 2 Bluetooth Gamepad

Symmetrical dual-stick layout with Switch and X-Input modes plus rear paddles for quick camera centering.

Check on Amazon

GuliKit KK3 Max Wireless Controller

TMR electromagnetic sticks, 1000 Hz wired/wireless polling, and Switch-layout face button caps included.

Check on Amazon

Affiliate disclosure: As an Amazon Associate, triforcerecomp.wiki earns from qualifying purchases at no added cost to you.