The ClickShare Desktop App enhances collaboration by simplifying content sharing in meetings. This guide outlines the parameters for the ClickShare Desktop App installer (MSI), helping IT administrators customize the installation process for their organization.
A typical scenario is that the IT administrator creates a Windows command script file that triggers a silent installation of the ClickShare Desktop App using msiexec.exe
Next to the general msiexec.exe parameters, the following ClickShare specific parameters can be passed to manage the deployment:
USER_EXP is a deployment parameter used to select a pre-configured user experience for an application. Once this experience is chosen during deployment, it becomes fixed and cannot be changed by end users through the application's preference settings. This ensures a consistent user interface and controlled experience across all instances of the application, preventing any customization by the end users and maintaining uniformity throughout the application's use. For full details about this parameter with the various ClickShare Desktop App MSI versions, click here.
Supported parameters
| Parameter | Accepted values | Description | Available in |
|---|---|---|---|
| ACCEPT_EULA | YES | Mandatory parameter |
|
| BETA_PROGRAM | YES, NO | Optional parameter Default value: YES To control the “Beta Program” UI option NO: NO UI option for Beta Program in the app | v4.19+ |
| PRODUCT_USAGE_ANALYTICS | YES, NO | Optional parameter Default value: YES To turn on and off “Usage Statistics” BETA_PROGRAM will be NO when PRODUCT_USAGE_ANALYTICS is set to NO | v4.13+ |
| YES, NO | Optional parameter Default value: NO To install the driver for App Based Conferencing (for app features without using a ClickShare Button e.g. Smart Meeting Flow) | v4.15 – v4.43 | |
| VIRTUAL_AUDIO_DRIVER | YES, NO | Optional parameter Default value: NO Use ONLY for certain laptops that have an audio issue VIRTUAL_AUDIO_DRIVER can only be YES when USER_EXP is set SA | v4.45+ |
| YES, NO | Optional parameter Default value: NO Use ONLY for certain laptops that have an audio issue VIRTUAL_AUDIO_DRIVER can only be YES when APP_BASED_CONFERENCING is set to YES | v4.19 – v4.43 | |
| | MINI, LARGE | Optional parameter Default value: Not Set To decide the UI style of the app (The UI style will be LARGE from 4.44 and onwards) MINI: The UI style is Mini, and the users cannot switch to the Large UI style LARGE: The UI style is Large, and the users can switch to the Mini/Large UI style Not Set: The UI style is Large, and the users can switch to Mini/Large UI style. | v4.41 – v4.43 |
| MINI, LARGE | Optional parameter Default value: Not Set To decide the UI style of the app MINI: The UI style is Mini, and the users cannot switch to the Large UI style LARGE: The UI style is Large, and the users can switch to the Mini/Large UI style Not Set: The UI style is the last setting or Large and the users can switch to Mini/Large UI style. | v4.35 – v4.40 | |
| MINI, LARGE | Optional parameter Default value: Not Set To decide the UI style of the app MINI: The UI style is Mini, and the users cannot switch to the Large UI style LARGE: The UI style is Large, and the users can switch to the Mini/Large UI style Not Set: The UI style is the last setting or Mini and the users can switch to Mini/Large UI style. | v4.23 – v4.34 | |
| CALENDAR_INTEGRATION | YES, NO | Optional parameter Default value: Not Set To turn on and off “Calendar Integration” and its UI option NO: Calendar Integration is turned OFF and the users cannot see the UI option in the app YES: Calendar Integration is turned ON and the users can see the UI option to turn it OFF/ON in the app Not Set: Calendar Integration is turned OFF and the users can see the UI option to turn it OFF/ON in the app Starting from version 4.27.2, the Calendar Integration feature is disabled by default when upgrading the App via auto update or MSI installer. The CALENDAR_INTEGRATION parameter, introduced in version 4.28, allows administrators to explicitly control this behavior during installation. | v4.28+ |
| AUTO_UPDATE | YES, NO | Optional parameter Default value: YES To control if the app will be automatically updated or not | v4.28+ |
| EXTENDED_DESKTOP | YES, NO | Optional parameter Default value: Not Set To install the Extended Desktop driver NO: The Extended Desktop driver will not be installed YES: The Extended Desktop driver will be installed Not Set
| v4.31+ |
| USER_EXP | BB SB SA | Optional parameter Default value: SA To select a pre-configured user experience. Once the experience is chosen in the deployment, it cannot be changed in the application preference by end users. BB (Basic Button): Intuitive sharing experience with simplified UI flow.
| v4.45+ |
| BB SB SA | Optional parameter Default value: SA To select a pre-configured user experience. Once the experience is chosen in the deployment, it cannot be changed in the application preference by end users. BB (Basic Button): Intuitive sharing experience with simplified UI flow.
| v4.44 | |
| LUI BB SB SA | Optional parameter Default value: LUI To select a pre-configured user experience. Once the experience is chosen in the deployment, it cannot be changed in the application preference by end users. LUI: Experience prior to 4.37, planned to be deprecated before the end of 2024. BB (Basic Button): Intuitive sharing experience with simplified UI flow.
| v4.38 – v4.43 | |
[This parameter is deprecated in v4.28 and onwards] | Valid directory | We have migrated away from the default installation in C:\ClickShareApp in Desktop app from v4.28 and up towards a generic installer which is installed in C:\Program files (x86)\Barco\ClickShareApp\. When a user first signs into a Windows user profile, the installer is launched and a copy of ClickShareApp is installed in that user's %LocalAppData%\ClickShare. So, every user has their own ClickShare instance running. | v4.4 – v4.27.2 |
Features of USER_EXP
Please refer to the respective section below for details on using the USER_EXP parameter with your ClickShare Desktop App MSI version.
Version: 4.44 and onwards
| Installation | Desktop app not installed | Desktop app installed with MSI (4.44+) | ||
|---|---|---|---|---|
| App Type | Button App (v4.44) | Basic Button | Smart Button | Smart App |
| UI Mode (Switch Toggle) | Yes New (Large) | No New (Large) only | No New (Large) only | No New (Large) only |
| Work Mode | with Button only | with Button Only | with Button Only | with Both App and Button |
| Smart Meeting Flow | No | No | Yes | Yes |
| APP_BASED_CONFERENCING DRIVER | No | No | No | Yes |
| PresentSense | No | No | No | Yes (can be turned on/off with app UI setting) |
Version: ~v4.37 and 4.38 - 4.43
| Installation | Desktop app not installed | Desktop app installed with MSI (4.38 - 4.43) | ||||
|---|---|---|---|---|---|---|
| App Type | Button App (v4.38 - 4.43) | Button App (~v4.37) | Basic Button | Smart Button | Smart App | Legacy |
| UI Mode (Switch Toggle) | Yes New (Large) / Old (Small) | Yes New (Large) / Old (Small) | No New (Large) only | No New (Large) only | No New (Large) only | Yes New (Large) / Old (Small) |
| Work Mode | with Button only | with Button only | with Button Only | with Button Only | with Both App and Button | with Both App and Button |
| Smart Meeting Flow | No | No | No | Yes | Yes | Yes |
| APP_BASED_CONFERENCING DRIVER | No | No | No | No | Yes | Yes (can be turned on/off with option) |
| PresentSense | No | No | No | No | Yes (can be turned on/off with app UI setting) | Yes (can be turned on/off with app UI setting) |
Command line examples
# Normal installation
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES
# Disable usage analytics
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES PRODUCT_USAGE_ANALYTICS=NO
# Install to non-default path
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES TARGETDIR=D:\CSApp
# Normal installation + install the App-based Conferencing drivers
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES APP_BASED_CONFERENCING=YES
# Installation with disabling Beta Program
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES BETA_PROGRAM=NO
# Installation with Mini UI
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES DEFAULT_UI=MINI
# Installation with disabling Calendar Integration
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES CALENDAR_INTEGRATION=NO
# Installation with disabling Auto Update
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES AUTO_UPDATE=NO
# Installation with Extended Desktop Driver
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES EXTENDED_DESKTOP=YES
# Enable Basic Button experience
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES USER_EXP=BB
# Enable Smart Button experience
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES USER_EXP=SB
# Enable Smart App experience
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES USER_EXP=SA
# Enable Legacy UI experience
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES USER_EXP=LUI
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES
# Disable usage analytics
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES PRODUCT_USAGE_ANALYTICS=NO
# Install to non-default path
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES TARGETDIR=D:\CSApp
# Normal installation + install the App-based Conferencing drivers
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES APP_BASED_CONFERENCING=YES
# Installation with disabling Beta Program
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES BETA_PROGRAM=NO
# Installation with Mini UI
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES DEFAULT_UI=MINI
# Installation with disabling Calendar Integration
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES CALENDAR_INTEGRATION=NO
# Installation with disabling Auto Update
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES AUTO_UPDATE=NO
# Installation with Extended Desktop Driver
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES EXTENDED_DESKTOP=YES
# Enable Basic Button experience
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES USER_EXP=BB
# Enable Smart Button experience
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES USER_EXP=SB
# Enable Smart App experience
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES USER_EXP=SA
# Enable Legacy UI experience
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES USER_EXP=LUI
! Info – MSI Deployment:
If you see api.amplitude.com being rejected by your firewall or proxy, this is the statistics engine of the client attempting to upload anonymous usage information. It can be disabled individually per client or system-wide with the PRODUCT_USAGE_ANALYTICS=NO switch. The installed client may need to be deleted from the system(s) before installing the MSI again. The latest client performs a complete uninstall before re-installing the client — If the original driver was in use by the OS during the MSI installation, the PC will need to be rebooted to reload the HIVE.
See the following KB articles for information on how to install the MSI file through Windows Command Scripts.
Troubleshooting tips
If there are any issues, it is possible to create a .txt file including the detailed log of the MSI deployment. To do so browse to the folder where the ClickShare Desktop App msi file is stored and use command:
msiexec.exe /i ClickShare_Installer.msi /qn ACCEPT_EULA=YES EXTENDED_DESKTOP=YES
CALENDAR_INTEGRATION=NO APP_BASED_CONFERENCING=YES DEFAULT_UI=MINI /L*v .\toto.txt
CALENDAR_INTEGRATION=NO APP_BASED_CONFERENCING=YES DEFAULT_UI=MINI /L*v .\toto.txt
This will create a log file called "ilog.txt" in the current working directory with the detailed Windows Installer Package logs. See KB2149 for details.
💡TIP: Don't forget to add the PATH where the MSI file is stored into the command line.
msiexec.exe /i <PATH>ClickShare_Installer.msi /qn ACCEPT_EULA=YES EXTENDED_DESKTOP=YES
CALENDAR_INTEGRATION=NO APP_BASED_CONFERENCING=YES
