TouchDesigner on Linux [v1.2] - Automated Installer, Auto-Patching & Multi-version

Hi everyone!

Like many of you, I’ve been wanting to use TouchDesigner on Linux for a long time. So I made a fully automated installer and environment manager that handles everything in a single command.

It delivers a true native experience with multi-version management, built-in maintenance tools, native Wayland optimizations, and automated system fixes.

You can find the GitHub repository here.

:penguin: One-Command Installation :

The script is completely idempotent, meaning you can rerun it at any time to update or repair your setup without breaking your existing environment.

To try the automated install :

curl -sSL https://raw.githubusercontent.com/iswad-lab/TouchDesigner-Linux/main/install.sh | bash

Key Features (v1.2) :

  • Multi-Version Support: Install and run multiple TD versions side-by-side.

  • Auto .toe Font Patching: Automatically detects and fixes missing UI fonts on launch using native toeexpandand toecollapse utilities under the hood (with automatic 30-day backups).

  • Lifecycle Menus: Rerunning the script lets you easily Update (components, winetricks, DXVK) or Uninstall cleanly.

  • Wayland Optimizations: Includes dedicated stability workarounds (like the use of XWayland) to bypass UI bugs on modern desktops.

  • Desktop Integration: Automatically generates application icons and clean file associations for your .toe / .tox files:

Supported Distributions :

The script supports the major Linux families and popular distros:

  • Arch-based: Arch Linux, CachyOS, Manjaro, etc.

  • Debian/Ubuntu-based: Ubuntu, Linux Mint, Pop!_OS, etc.

  • Fedora-based: Fedora, RHEL, etc.

  • openSUSE-based: Tumbleweed, Leap, etc.

Feedback & Support :

I use this setup daily for creative production. On my machine, it actually runs cooler than on Windows.

I really need your feedback! Since hardware/driver combinations are infinite on Linux, please share your success or issues here, or contribute directly on GitHub!

Thanks,
Iswad

16 Likes

This is great! Thanks for the tag

1 Like

Really Cool.

It works for me on an old computer with 970 GPU and Brazzite.

Thx for the Text Fix too @c0deous

2 Likes

Hey, thanks a lot, great job! I use arch + hyprland wm. All have installed and launched without any issues. Couple of question I have:

  1. In repo there is mention of font fix tox file, I have a missing mono font warning in the textport, what should I do with this .tox file to fix this?

  2. I have a small visual glitch in the transport panel, is it expected?

1 Like

Hi, thanks for the feedback !

The glitch in the transport panel is a font rendering issue. Just drag and drop the .tox from the repo into your session to fix the UI. In the next update (v1.1.0 release on GitHub), the script will auto-install this fix into your Palette (My Components)

Also, could you paste the exact warning from the textport? I’ll check if a specific font is missing.

Thanks for testing :slight_smile:

will do once I’m back home!

1 Like

“Error Loading Default Mono Font. Failed to load font file. Failed to load . Substituted with Verdana.” Here’s the message

1 Like

[EDITED] - This issue is automatically fixed since v1.2

Ok thanks for sharing the message.

This error is usually a non-blocking Wine fallback. If the UI looks correct after applying wine_ui_fixes.tox, it can be safely ignored.

I also just pushed v1.1.0, which improves the current font and UI fix workflow (including the font-fix desktop entry) to make this Linux/Wine issue more reliable.

You can re-run the install script without uninstalling your current TouchDesigner version, then:

  1. Open Palette > My Components

  2. Refresh Folder

  3. Drag wine_ui_fixes.tox into your network

  4. Click Enable / Fix Now, and voila !

You can either use the font-fix desktop entry, or use the default one and set your own default startup .toe project.

1 Like