Install the Whatfix Desktop Player
- 30 Jun 2025
- 6 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
Install the Whatfix Desktop Player
- Aktualisiert am 30 Jun 2025
- 6 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
The content is currently unavailable in German. You are viewing the default English version.
Artikel-Zusammenfassung
Fanden Sie diese Zusammenfassung hilfreich?
Vielen Dank für Ihr Feedback
Note:
- 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.
- Whatfix applications work either as 64-bit or 32-bit processes through a back-end configuration.
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
| 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 |
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.
Use the Installation Wizard
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.
Note:
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.
Note:
- 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
Use the Command Prompt
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}" HP="{HOSTED_PATH}" DD="{DEV_DOMAIN}" PORT="{PORT_NUMBER}" INSTALLPATH="{INSTALL_PATH}" /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.
| 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 |
HP | The hosted path (HP) parameter is the URL of your hosting environment. By default, it points to https://cdn.whatfix.com. In case you are using a Self Hosted mode of deployment, replace {HOSTED_PATH} with your own host URL. | No |
DD | The development domain (DD) is the URL of the server where the installer is built. By default it is https://whatfix.com. Replace {DEV_DOMAIN} with your own URL. | No |
PORT | The port number is used for debugging. By default, it is empty. Replace {PORT_NUMBER} with your preffered port number. | No |
INSTALLPATH | This is the location where the Player is installed on your desktop. By default, it is in your local application data folder. Replace {INSTALL_PATH} with your preferred install location. | No |
/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}" HP="{HOSTED_PATH}" DD="{DEV_DOMAIN}" PORT="{PORT_NUMBER}" INSTALLPATH="{INSTALL_PATH}" /q
Virtual Desktop Installation
msiexec.exe /i {FILE_NAME} ORG="{ORG_ID}" APP="{PATH_TO_APPLICATION}" ENV="Citrix"
| 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 |
HP | The hosted path (HP) parameter is the URL of your hosting environment. By default, it points to https://cdn.whatfix.com. In case you are using a Self Hosted mode of deployment, replace {HOSTED_PATH} with your own host URL. | No |
DD | The development domain (DD) is the URL of the server where the installer is built. By default it is https://whatfix.com. Replace {DEV_DOMAIN} with your own URL. | No |
PORT | The port number is used for debugging. By default, it is empty. Replace {PORT_NUMBER} with your preferred port number. | No |
INSTALLPATH | This is the location where the Player is installed on your desktop. By default, it is in your local application data folder. Replace {INSTALL_PATH} with your preferred install location. | No |
/q | This parameter ensures that the installation of the Player is done silently on your desktop. | No |
APP | The APP parameter is the complete path of the required application in the server machine. For example, C:\Program Files\Windows NT\notepad. Replace {PATH_TO_APPLICATION} with the path to your underlying application. | Yes |
ENV | The environment (ENV) is the virtual workspace where the Player needs is deployed. It is Citrix for both Citrix and AVD | Yes |
System Level Distributor
msiexec.exe /i {FILE_NAME} ORG="{ORG_ID}" /q /l*v out.txt
| 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.
Note:
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.
Use the registry
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.
Use file location
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.
War dieser Artikel hilfreich?