Automatic Key Installation
To aid in deploying TouchDesigner onto many computers, keys can be installed automatically instead of manually using the Key Manager Dialog. Note: this method only works if no keys are currently enabled on the machine.
This is done by first:
- creating a file called TDAutoKey.txt on the desktop of the target computer
- running Touchdesigner
As with the regular License Install preocedure, an active Internet Connection is necessary.
The TDAutoKey.txt file will need to have some required information such as your username and password, and there are a few optional options that can be specified if desired. The format of the .txt file is
setting = value
- You must be an administrator when you install on macOS and will need to startup TouchDesigner once as an administrator after the key is installed. Afterwards, any user will be able to use TouchDesigner.
The first two pieces of information are the username/password for the Derivative account that contains the key you wish to install
username = <DerivativeAccountUsername> password = <DerivativeAccountPassword>
Next you need to specify the type of key you wish to install:
product = <ProductName>
license = <LinceseType>
Since 099 has update dates, by default a license with an update date the farthest into the future will be selected. You can instead select one with the closest update date by setting:
updateDate = closest
If this is not set, then it behaves as if the option is set to:
updateDate = farthest
To control if a dialog comes up upon successful installation of a key use this setting. It defaults to 'true' if not specified
notifySuccess = <TrueOrFalse>
To control if a dialog comes up if any error occurs use this setting. It defaults to 'true' if not specified
notifyFailure = <TrueOrFalse>
To automatically delete the TDAutoKey.txt after a successful key installation use this setting. It defaults to 'false' if not specified
deleteAfterSuccess = <TrueOrFalse>
An example TDAutoKey.txt file is located File:TDAutoKey.txt. The username and password fields should be changed to match the account being used.
See Also: License Dongle