Setting Configuration Values via Config files

Certain advanced configuration values are set via configuration files, rather than via the user interface, command line, or URI methods. These files are read and implemented by the Software Client for macOS when it launches.

Configuration files can be saved in a system-scoped location, for settings that should apply to any PCoIP client launched on a device, or a user-scoped location, for settings that should apply to specific users. If a setting is found at both levels, the system scope takes precedence.

Configuration files do not exist until a user changes a persistent setting via the user interface. If that has not ocurred, you must create the file, either manually or using a deployment script.

Setting Config Values

Configuration values are set via plist settings. Each setting is specified by a write command:

User-scope setting:

defaults write "com.teradici.Teradici PCoIP Client" <Key> <value>

System-scope setting:

sudo defaults write "/Library/Preferences/com.teradici.Teradici PCoIP Client.plist" <Key> <value>

For example, the following file would add the USB device identified by the VID/PID pair 18a5,0302 to the local termination blacklist, causing it to revert to bridged connections:

defaults write "com.teradici.Teradici PCoIP Client" localtermination_black_list "18a5,0302"

Config File Locations

Depending on the desired scope, write settings to the plist file in one (or both) of these locations. Remember that the system-scoped file takes precedence over the user-scoped file:

Scope	Location
System	/Library/Preferences/com.teradici.Teradici PCoIP Client.plist
User	~/Library/Preferences/com.teradici.Teradici PCoIP Client.plist