TouchDesigner on Linux - Automated Installer, Auto-Patching & Multi-version

General TouchDesigner Discussion
, ,
1

0
01919×1050 246 KB

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, Wayland optimizations, and automated system fixes.

You can find the GitHub repository here.

:penguin: One-Command Installation :

Script_Preview
Script_Preview901×642 39.9 KB

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

Any distro (recommended):

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

Arch Linux (AUR):

paru -S touchdesigner-linux

Key Features:

  • 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 toeexpand and 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.

  • Diagnostic Tool: Run td-install --diagnose to check GPU, Vulkan and Wine status in one command.

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

    SVG_Preview
    SVG_Preview495×180 14.3 KB

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.

Support:

The project is actively maintained. Check the full roadmap here, or open an issue for bugs and feature requests.

Thanks,
Iswad

16 Likes
What will it take to get derivative to make TD for linux?
What will it take to get derivative to make TD for linux?
Linux version
2

This is great! Thanks for the tag

1 Like
3

Really Cool.

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

Thx for the Text Fix too @c0deous

2 Likes
4

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?

    2026-05-12-201648_hyprshot
    2026-05-12-201648_hyprshot1752×193 11.5 KB

1 Like
5

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:

6

will do once I’m back home!

1 Like
7

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

1 Like
8

[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
9

I would like to understand the trick with patching the ids-DLLs. Could you explain why setting the operating system version to zero is supposed to help (maybe even: why the same fix applied manually does not do anything)?

10

Hi. You’re looking at the right area, but the field being zeroed is AddressOfEntryPoint, not majorOperatingSystemVersion.

In the PE header, e_lfanew + 40 (after signature + COFF header + 16 bytes into the optional header) is the entry point. Zeroing it tells the loader this DLL has no DllMain to call, so Wine skips it entirely when the DLL loads at startup. The DLL’s actual functions (used when an IDS camera is connected) still work fine though.

The reason your manual patch didn’t work is probably that you patched e_lfanew + 48 (where majorOperatingSystemVersion lives) instead.

Please check your hex editor: the 4 bytes at e_lfanew + 40 should be 00 00 00 00.

1 Like
11

Thank you! I made the +40 calculation in Decimal on top of a hex offset. Now I get it!

1 Like