TouchDesigner-Linux

An installer project that detects your Linux setup, handles the Wine prefix, fixes fonts, and manages TouchDesigner updates without reinstalling anything.

TouchDesigner does not have an official Linux installer, so this project is the workaround: an automated installer, fixes, icons, and more for running TouchDesigner on Linux. The approach is Wine based, with a launcher script, a Wine prefix, and patched files handled behind the scenes. The project is written in Python and licensed MIT.

The installer auto-detects the distro and environment. A graphical session gets a full install with desktop shortcuts. SSH or headless setups skip the GUI-only steps. NVIDIA users are told to install the GPU driver first and reboot. SteamOS gets special handling, with the read-only root filesystem disabled automatically through a command that needs the sudo password.

Updating runs the installer and picks option 2, regenerating the launcher, winetricks, DXVK, and UI fixes without reinstalling TouchDesigner or recreating the Wine prefix. Option 3 uninstalls. The README carries a clear warning about a full uninstall: it removes everything, including the TouchDesigner license activation file, so the license key has to be re-entered after reinstalling, though the uninstaller warns before deleting it.

The first launch has a known quirk. The font fix is injected into .toe files on launch, but the license activation screen loads before any .toe file, so text may look broken until the license is entered. The steps: launch, enter the license, close, and relaunch, at which point the fonts are fixed. A documentation section covers how each fix works, compatibility status, a Wine runners comparison of tested runners, troubleshooting, and advanced tools for expanding and collapsing files. Everything lives under a base directory with auto-backups of patched .toe files.

• Source 1 · Project repository
• Source 2 · README