Knowledge Base
Apply your customization to an installed module
Last Modified 13 мар. 2024 г.
How to apply your customization to an installed module
While being connected to the Internet
To apply your customization to an installed module while being connected to the Internet, please follow the instructions below:
- Open the Command Prompt (CMD).
- Navigate to the TeamViewer installation folder.
- (Per default, it should be: %Program Files(x86)%\TeamViewer or %Program Files%\TeamViewer)
- Enter the following command into the command line:
- TeamViewer.exe customize --id paste_your_customization_id_here
- Confirm with Enter.
While not being connected to the Internet
To apply your customization to an installed module while not being connected to the Internet, please follow the instructions below:
- Download the custom config .zip file from the following URL:
- https://configdl.teamviewer.com/configs/<customconfig id>.zip
- Please replace <customconfig id> with the CUSTOMCONFIG you obtained in Step 2.
- Open the Command Prompt (CMD)
- Navigate to the TeamViewer installation folder
- (Per default, it should be: %Program Files(x86)%\TeamViewer or %Program Files%\TeamViewer)
- Enter the following command into the command line:
- TeamViewer.exe customize --path path_to_customization_ZIP
- Confirm with Enter
In both methods, customization will be applied to your module.
The visual changes (logo, color, textual changes, disclaimer, and terms & conditions) will be visible after a restart. If you have used the optional parameter --restart-gui the TeamViewer client will automatically be restarted.
Main parameters
--id <customization_id>
Specifies the customization via the respective ID retrieved from the Management Console.
🚨 Cannot be combined with --path.
--path <path_to_zip>
Instead of using --id, you can specify the customization zip file. UNC paths are also accepted. The user executing the command needs access rights to that path.
🚨 Cannot be combined with --id
--restart-gui
This parameter restarts the TeamViewer client. The restart applies the visual changes of the given customization (logo, color, textual changes, disclaimer, and terms & conditions).
--remove
This option removes an already applied customization if there is any. Without this option, the second customization would fail otherwise.
You can already specify the following customization via --id or --path to be applied after the removal has finished.
Error codes
| Error codes | Description | Problem/Solution |
|---|---|---|
1 | Invalid command line arguments | There is an issue with the command line arguments. Check the used options to see if they can be combined or if there is a typing error. The TeamViewer log file may contain more information about this issue. |
500 | An internal error occurred | The processing of the custom configuration failed with an unspecific error. See the TeamViewer log files for more details. |
501 | The current user was denied access | You need to have administrative rights to execute the Customization. Retry with a user who has administrative rights. |
502 | The download of the custom configuration timed out | Check the Firewall if it is blocking access to TeamViewer servers. |
503 | Invalid module | The given file was made for a different type of TeamViewer client. For example, you can only use Host custom configuration files for TeamViewer Host |
504 | Restart of the GUI failed | The GUI did not start as requested by the "--restart-gui" option. Try to restart the GUI manually. |
505 | Custom configuration failed | While applying the custom configuration, an error occurred. See the TeamViewer log files for more details and check if the custom configuration is still valid. |
506 | Removal of custom configuration failed | While trying to remove the custom configuration, an error occurred. See the TeamViewer log files for more details. |