- To install Whatfix Desktop Player, end users need to choose between the data centers, either US or EU, and then install the Player.
- The Player is installed either at a user level or system level based on the requirements of the end users.
- Avoid downloading multiple players; doing so can cause some performance issues of the player. If you already have a player installed at the system level, it's best to avoid downloading another at the user level.
Installation methods
There are two methods of installation for the Whatfix Desktop Player.
1. Installer
The Whatfix Player is installed either at a system level or user level on a machine. This method of installation is the most used one.
2. System Level Distributor
A distributor file is installed at the system level, triggering the installation of the Whatfix Player after a user in the system logs in, if they don't already have it. This ensures that users added to the system later automatically get the Player. It also ensures that the Player is reinstalled for the user if it gets uninstalled. Administrator privileges are required for this installation method.
The installation happens at the local user level.
Auto-update of the Player
Whatfix provides the capability to automatically update the Player whenever there is a new version. Auto-updates are available for the User Level Installation and System Level Distributor (only at the user level) Installation methods. For more information, see Auto-update of the Whatfix Desktop Player.
Comparison of installation methods
| Field | User Level | System Level | System Level Distributor |
|---|---|---|---|
| Ideal usage | By individuals such as end users or content creators | By IT admins installing the Player on virtual machines such as Citrix or Azure Virtual Desktop | By IT Admins installing the Player in bulk for all users. |
| Who can use this method? | Anyone | System administrators | System administrators |
| Auto updates | Available | Not Available | Available (only at the user level) |
Download the installer
Here's the link to download the installer.
| Installer | System Level Distributor |
|---|---|
| US | US |
| EU | EU |
The recommended installer is the user level installer for use.
Install the Player
The Player is installed in two ways:
- Use the Installation Wizard: Only User Level and System Level installation are done this way.
- Use the command prompt: All installation methods, including virtual machine installation, are done this way.
-
Open the downloaded installer file to launch the installation wizard.
-
Click Next to continue the installation.

-
Choose whether to install the Player for yourself or for all users of the machine.

-
If you choose to install it only for yourself, the default location is C:\Users\
\AppData\Local\ -
If you choose to install it for all users, the default location is C:\Program Files (x86)\Whatfix\
-
In the Destination Folder window, click Next to install the file in the default location or click Change... to choose a different location.

-
In the Player Arguments window, enter your ORG ID, and then click Next.

- To get the ORG ID, contact your Whatfix Representative.
- ORG ID is case-sensitive.
-
On the Ready to install Whatfix Player dialog box, click Install to finish the installation.

-
On the Whatfix Player Setup window, click Finish

-
Open Windows Command Prompt and use the following command to change the current directory to the downloaded folder:
cd {Path to downloads directory}

-
Depending on the installation method you choose, run the following command to install Whafix Player:
User Level Installation
msiexec.exe /i {FILE_NAME} SCOPE="per-user" ORG="{ORG_ID}" /q
The following table explains the various parameters and values used in the command. Omit those that are not mandatory and use their default values. Replace the parameter values within quotes with the necessary values.
| Path | Description | Mandatory |
|---|---|---|
{FILE_NAME} |
The file name of the downloaded installer. | Yes |
ORG |
Your Organization ID. Contact your Whatfix Representative to get your Organization ID, then replace {ORG _ID} with it. |
Yes |
/q |
This parameter ensures that the installation of the Player is done silently on your desktop. | No |
System Level Installation / Virtual Machine Installation
System Level Installation
msiexec.exe /i {FILE_NAME} SCOPE="per-machine" ORG="{ORG_ID}" /q
App Streaming ( Citrix Streaming/AVD)
Step 1: Install Whatfix Player on the streaming virtual machine.
a. Install the Whatfix Player on the virtual machine from which the application will be streamed to end users.
b. Run the installer using the following command at location where whatfix player msi is being downloaded:
msiexec.exe /i {FILE_NAME} SCOPE="per-machine" ORG="{ORG_ID}" ENV="Citrix"
| Path | Description | Mandatory |
|---|---|---|
{FILE_NAME} |
The file name of the downloaded Whatfix Player installer. | Yes |
ORG |
Your Organization ID. Contact your Whatfix Representative to get your Organization ID, then replace {ORG _ID} with it. |
Yes |
ENV |
The environment (ENV) is the virtual workspace where the Player needs is deployed. It is Citrix for both Citrix and AVD |
Yes |
This step installs the Whatfix Player on the streaming virtual machine only. The target application will not be available to end users until it is published through Citrix cloud.
Step 2: Publish the Application from Citrix/ AVD cloud.
a. After installing Whatfix Player, your IT/Citrix administrator must publish each target application from Citrix/AVD Cloud using WhatfixPlayer.exe as the launcher.
b. For every application that needs to be streamed, create a published application with the following configuration.
Example: Application 1
| Field | Value |
|---|---|
| Path | C:\Program Files\Whatfix\Whatfix Player\WhatfixPlayer.exe [For system level installer] |
| Command Line Parameters | startplayer false "C:<Full Path to TargetApp1.exe>" |
| Working Directory | C:\Program Files\Whatfix\Whatfix Player |
| Require Command Line (if available) | Yes |
Example: Application 2
| Field | Value |
|---|---|
| Path | C:\Program Files\Whatfix\Whatfix Player\WhatfixPlayer.exe |
| Command Line Parameters | startplayer false "C:<Full Path to TargetApp2.exe>" |
| Working Directory | C:\Program Files\Whatfix\Whatfix Player |
| Require Command Line (if available) | Yes |
Supporting Multiple Applications for app streaming via Citrix/AVD : If multiple applications need to be supported, create a separate published application for each target application.
System Level Distributor
msiexec.exe /i {FILE_NAME} ORG="{ORG_ID}" /q /l*v out.txt
| Path | Description | Mandatory |
|---|---|---|
{FILE_NAME} |
The file name of the downloaded installer. | Yes |
ORG |
Your Organization ID. Contact your Whatfix Representative to get your Organization ID, then replace {ORG _ID} with it. |
Yes |
/q |
This parameter ensures that the installation of the Player is done silently on your desktop. | No |
/l*v |
These are the installer logs. | No |
- Press the Enter key.
If there is no error message, the installation is successful.

- When the installation is complete, open the desktop application to view Whatfix content.

Validate the installation
After you have finished the Player installation process, check whether it is installed in your system in the following ways:
- Use file location: This method is used to validate the Player's installation for all installation methods
- Use the registry: This method is used to validate the Player's installation for all methods.
This is a standard method of validation wherein IT Admins can use the Windows Registry to check whether the Player's distributor file is installed, even if they do not have access to end-user registry. This method does not require accessing the user's profile.
- Go to your computer's Registry Editor.
- Under HKEY_LOCAL_MACHINE, click SOFTWARE.

- Depending on the installation method, verify whether the following file exists:
System Level Installer
Double-click the Whatfix folder to see the Registry Entry of the Player.

System Level Distributor
-
The PlayerBulkManager file is present under a folder titled Whatfix.

-
Double-click PlayerBulkManager to see the Registry Entry of the Player.

User Level Installation
Double-click the Whatfix folder to see the Registry Entry of the Player.

Depending on the installation method, verify whether the following folder exists to validate whether the installation was successful:
User Level Installation
AppData > Local > Whatfix Player
System Level Installation
Program Files > Whatfix > Whatfix Player
System Level Distributor
Program Files > Whatfix > Player MSI Manager
Troubleshooting
If you face issues with installation, see Unable to install Whatfix Desktop Studio or Player.