Difference between revisions of "Install TouchDesigner"

From Derivative
Jump to navigation Jump to search
Line 103: Line 103:
If you get a '''L1 Key Error''' when installing your key (see image below), follow these instructions.
If you get a '''L1 Key Error''' when installing your key (see image below), follow these instructions.
* in your admin account, open Terminal and paste in the command:
* In your admin account, open Terminal and paste in the command:
   ls -l  -d "/Library/Application Support/ca.derivative"
   ls -l  -d "/Library/Application Support/ca.derivative"
You should get a line back like so:
You should get a line back like so:

Revision as of 23:24, 25 October 2018

How to install TouchDesigner[edit]


  • Download the latest version of TouchDesigner from here


  • Double-click the TouchDesigner099.xxxx.xxxxx.64-Bit.exe file and follow the instruction on the installer dialog. Please make sure you are installing from an Administrator account.


  • Double- click the TouchDesigner099.xxxx.xxxxx.dmg file and then drag the TouchDesigner icon to your Applications folder.


  • When opening TouchDesigner099 for the first time, the Key Manager Dialog will guide through the process of installing a license.

Installer Options[edit]

  1. You can make TouchPlayer the default application associated with TouchDesigner files by choosing "Custom install and TouchPlayer options" and selecting "Make Default for .toe files" on the following page.
  2. You can choose to "Install Runtime for Dongle Licensing" if you are planning to use TouchDesigner with a License Dongle

Installing Multiple Builds at Once[edit]

Sometimes you will want multiple builds of TouchDesigner or TouchPlayer installed at the same time. You may need older builds to test previous projects, or you may want to try out the latest features in Experimental while keeping Official installed for your current project.


Using the Windows installer only allows one installation of TouchDesigner at a time so here is a workaround.

  • Install your 'main' build (build you use the most) using the installer. This build will open when you double-click on .toe or .tox or TouchDesigner related file types.
  • For additional builds, use the /extract feature of the installer described in the section below. Run this in the Windows Command Prompt
TouchDesigner099.xxxx.xxxxx.64-Bit.exe /extract
  • The folder extracted to will have a random name, rename this folder to the build number and place it anywhere convenient.
  • Create a shortcut to the TouchDesigner099.exe inside the installation's 'bin' folder. Rename the shortcut to include the build number for clarity. You can then place this shortcut anywhere convenient and drag-n-drop .toe and .tox files to it when you want to open using that specifc build.


  • Just drag the application to any convenient location. If it conflicts with another TouchDesigner build already there, select "Keep Both" from the pop-up dialog. To keep it more organized, you can rename the application file to include the build number.
  • Right-clicking on any TouchDesigner file and selecting 'Open With >' will show a list of all TouchDesigner builds on the computer, just select the one you wish to use.

Useful Installer Command-line switches on Windows based Systems[edit]

The Installer can be used with a variety of command-line switches:

  • /exenoui - Launches the EXE setup without UI.
  • /extract - Extracts the files contained in the installer.
TouchDesigner099.xxxx.xxxxx.64-Bit.exe /extract

You can also specify a location, the full path to an existing folder is required. If the path contains spaces you must enclose it in quotes:

TouchDesigner099.xxxx.xxxxx.64-Bit.exe /extract "C:\My Files\TouchDesigner"
  • /quiet - Run installer in quiet mode (there is no user interaction).
  • /passive - Run installer in unattended mode (the installation shows only a progress bar)

For a full list of Command-line switches, please refer to this article: https://msdn.microsoft.com/en-us/library/windows/desktop/aa367988(v=vs.85).aspx

Problems during Installation on Windows OS[edit]

Installer exits during installation or aborts with an Error[edit]

When the Installer exits during Installation without giving a sufficient reason, start a Windows Command Prompt window with Administrator privileges and run:

"C:\MyFolder\TouchDesigner0xx.xxxxx.xx-Bit.exe" /L*V "example.log"

Send the resulting log file as a zip or link including a description of the encountered error to Derivative Support

Note: If you persistantly run into an issue with the installer, you can try running TouchDesigner without actually installing it. To some extent the installer just copies files to disk and makes sure that some prerequisites are met. All the required files are contained seperatly in the installer and can be extracted to disk using following command in a standard Windows Command Prompt

TouchDesigner099.xxxx.xxxxx.64-Bit.exe /extract "C:\My Files\TouchDesigner"

The extracted folderstructure will contain a bin folder in which you can find TouchDesigner099.exe

Installer can't continue because of insufficient access rights to folder[edit]

This behaviour can happen during the de-installation phase of a previously installed version. The best way around this is to restart your computer and start the installation process again.

Installer can't remove previous installed TouchDesigner version[edit]

In some cases the Installer will quit because it was not able to uninstall a previously installed TouchDesigner version.

Follow the instructions on the Microsoft Article here. This solution is now available for all Windows versions TouchDesigner is supporting.

Alternatively Geekuninstaller, available free from here, has had good results when trying to resolve install and uninstall related problems.

If the error is persistent, try re-installing the previously installed version of TouchDesigner, remove it via the Windows "Apps & features" Dialog and try installing the new version again.

Problems after Installation on Windows OS[edit]

Installing missing libraries for Windows N and Windows KN distributions[edit]

Windows N and Windows KN versions are made for the European and Korean market and do to antitrust regulations do not include Windows Media Player which parts of are required to run TouchDesigner.

You can download and install the missing features for

An unexpected licensing error has occurred[edit]

In some cases starting TouchDesigner will fail with a License Retrieval Error. The content of the error message will look similar to this:

License Retrieval Error

Best success with resolving this has been rebuilding the wmi repository.

Please be advised though that deleting and rebuilding the repository can cause damage to the system or to installed applications.

Open a Command Prompt with Administrative Rights and run:

winmgmt /resetrepository

Problems after Installation on macOS[edit]

Permissions Error when installing a key[edit]

If you get a L1 Key Error when installing your key (see image below), follow these instructions.


  • In your admin account, open Terminal and paste in the command:
  ls -l  -d "/Library/Application Support/ca.derivative"

You should get a line back like so:

   drwxrwxr-x@ 10 root  admin  340 17 Jan  2017 /Library/Application Support/ca.derivative
  • If you do not have admin as a group (4th column), then enter these commands in the Terminal:
   cd  "/Library/Application Support"
   sudo chgrp -R admin ca.derivative
  • Restart TouchDesigner and try installing the key again.

Problems during Uninstall[edit]

Installer exits during Uninstall without error[edit]

When this happen, best practice has been to restart the computer to free up any possible locks on the folder. Most commonly after a restart the remaining files will have been removed and a fresh install can be started.