To get more information on how TG Pro works, the available features and how to use them, see our in-depth app tutorial. Or download the free 14-day trial and give it a try.
This will guide through the steps to remotely install, license and setup custom preferences for TG Pro. This is especially useful for enterprise environments where a system administrator will want to install TG Pro on multiple computers with a remote deployment tool. Just follow the steps below and if there are any issues, please feel free to reach out to us via email or Twitter.
This is a fairly simple step as all that's necessary is to copy the TG Pro app bundle (.app) to the Applications folder on the remote Mac, or whichever folder is required.
One of the best parts of TG Pro is how the features can be customized, such as email notifications, Auto Boost fan control rules, what's shown in the menu bar icon, logging, etc. All of these are controlled by the preferences. As part of a remote deploy, the preferences need to be setup. The preferences will be installed from a plist file, which is a common format for them on macOS. A plist file can easily be edited by Xcode (free) or view the list of plist editors (paid) from the App Store.
Here's what it will look like when opened in Xcode:
Download the plist file below, which contains all available preferences, to get started:
Open the plist file (it may need to be unzipped depending on the browser used) and edit the key/value pairs to suit the requirements of the install. Below is a table of the available key/value pairs grouped by section, along with a description and possible values:
Auto Boost rules are stored in a proprietary format, so it's not easy possible to add them to the plist file. To resolve this, the rules can be described in the plist, and TG Pro will parse them, create the rules and store them.
When using Auto Boost rules, make sure the fan control mode is set to "Auto Boost" to enable this feature. Also worth noting is for Mac's that have the T2 chip (2018-2020 MacBook Pro, MacBook Air, Mac Mini & iMac Pro), the option to override system control and use Auto Boost instead of Max Boost is necessary, otherwise the app will treat each rule as 100% fan speed. For more detail on why this is, please see this section in the app tutorial.
An example of what they look like in the plist:
The key/value pairs to use along with all the possible options:
For this step, all that's required is to copy the preferences plist file that's been setup to the remote Mac. For this example, the path chosen will be:
/tmp/var/TG Pro/prefs to install.plist
Note: It is possible to have the plist file on a network share instead of copying it to the remote Mac, as described in the step below.
TG Pro will be launched in a special mode that does not display any UI and silently installs the fan helper, licenses the app and installs the preferences.
The following table describes the available options:
Note: The command must be run as root to be able to install the fan helper.
Assuming that TG Pro is located in the top level Applications folder, here is an example that includes custom preferences:
sudo "/Applications/TG Pro.app/Contents/MacOS/TG Pro" -silentSetup -licenseKey XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXX -licenseEmail firstname.lastname@example.org -prefsFilePath "/var/tmp/TG Pro/prefs to install.plist" -prefsUsername macuser
Here is another example that will install everything without changing the default preferences:
sudo "/Applications/TG Pro.app/Contents/MacOS/TG Pro" -silentSetup -licenseKey XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX -licenseEmail email@example.com -prefsUsername macuser
TG Pro will now be setup with the provided preferences, licensed (trial dialog will not appear on launch) and full fan control. For fan control, a special helper app is installed in the following locations: