Windows Install Guide: Desktop Player (MSI Deployment)

Windows Install Guide: Desktop Player (MSI Deployment)

Prerequisites

  1. IT / Vibe Admin
    1. Read the Technical Requirements & Recommendations guide.
    2. Contact your Vibe Support team to request the latest Vibe Desktop player.msi installer.
    3. Install .Net Framework 4.0 on all target PCs before installing the Vibe.fyi Vibe Desktop Player app. [Learn more]
    4. Create the Desktop Channel licences for your Screensaver, Background Wallpaper, Lock Screen or Web Browser.
  2. Internal Comms:
    1. Follow the Desktop Channel content & playlist setup steps (before deploying the Vibe Desktop Player app)

Prepare MSI for deployment

Before deploying in quiet mode, update the SITE_URL, enable the relevant channels and enter the licence auth codes in the MSI.

Sample MSI commands

Main settings only (using defaults for the rest)
The Vibe Desktop player.msi installer includes the following default commands:
msiexec /i VibeDesktopPlayer.msi /quiet /l*v "log.log"  SITE_URL="https://[youruniquevibefyi]" ENABLE_SS="yes" SS_AUTHCODE="12345678" ENABLE_BG="Yes" BG_AUTHCODE="12345678" ENABLE_LS="Yes" LS_AUTHCODE="12345678"

Example with all switches
msiexec /i VibeDesktopPlayer.msi /quiet /l*v "log.log"  SITE_URL="https://[youruniquevibefyi]" DISABLE_APP_CLOSE="No" HIDE_SETTINGS="No" SS_WAIT_MIN="5" SS_ON_RESUME="Yes" CONSOLE_LOCK_TIMEOUT="Yes" ENABLE_SS="Yes" SS_AUTHCODE="12345678" SS_INFOBAR_SYNC_SEC="30" DISABLE_SS_INFOBAR="No" ENABLE_BG="Yes" BG_AUTHCODE="12345678" BG_IMAGE_INTERVAL_SEC="30" ENABLE_LS="Yes" LS_AUTHCODE="12345678" LS_TIMEOUT_MIN="60" RANDOM_START="Yes" SYNC_INTERVAL_MIN="30" WAIT_PLUG="1800" WAIT_PLUG_LOCK="1800" WAIT_BATT="600" WAIT_BATT_LOCK="600" SS_LOGO=”https://public_website_address/logo_file_name.png”
Info
If no switch is specified (i.e. SS_WAIT_MIN="5"), the default values shown in the list below will be applied.

MSI Switches

Use these MSI switches as needed.
Alert
Switch names are case sensitive and must be in all capital letters, while Switch values are not case sensitive.

Vibe.fyi player app

MSI Parameter
Function
Configuration
SITE_URL
(required)
Defines the unique Vibe.fyi Screensaver URL.
Enter the URL provided by your Vibe support team.
RANDOM_START
Prevents the same slide from always appearing first.
The Wallpaper and Screensaver slides can start at a random position. This setting can be enabled or disabled (Yes/No). 
Yes/No (Default = Yes)
Recommended: Enable this setting to randomise the starting slide position. RANDOM_START="Yes"
SYNC_INTERVAL_MIN
Sets the time interval (in minutes) between synchronising slide updates for the screensaver, desktop wallpaper and lock screen.
Enter the number of minutes (Default = 30).
HIDE_SETTINGS
Shows or hides the Desktop Player Settings menu.
Yes/No (Default = Yes).
It’s recommended that you restrict access to the Desktop Player app settings and prevent users from making any alterations.
DISABLE_APP_CLOSE
Enables or disables the ability to close the Desktop Player app.
Yes/No (Default = No).
AUTO_LOAD
Determines whether the app loads automatically on startup.
Yes/No (Default = Yes).
OVERWRITE_USER_SETTINGS (optional)
Controls whether manually changed user settings are overwritten during upgrades.
Yes/No (Default = Yes).

Windows Screen Saver Settings

MSI Parameter
Function
Configuration
SS_WAIT_MIN
Sets the wait time before the screensaver activates.
Enter time in minutes.
(Default = 5)
SS_ON_RESUME
Determines if the "On resume, display logon screen" option is enabled.
Yes/No (Default = Yes).
Power Options:*
  
CONSOLE_LOCK_TIMEOUT
Controls whether the Vibe.fyi Screensaver content is displayed when the lock screen is activated.
Yes/No (Default = Yes).
WAIT_PLUG
Sets the display turn-off time when plugged in.
Enter time in seconds (Default = 1800).
WAIT_PLUG_LOCK
Sets the display turn-off time when the screen is locked while plugged in.
Enter time in seconds (Default = 1800).
WAIT_BATT
Sets the display turn-off time when on battery.
Enter time in seconds (Default = 600).
WAIT_BATT_LOCK
Sets the display turn-off time when the screen is locked while on battery.
Enter time in seconds (Default = 600).
Info
*The Console Lock Display Off Timeout in Advanced Power Options determines how long the display stays on after the computer is locked, with a default of 1 minute. To ensure the screensaver activates while the lock screen is active, set the WAIT_ times longer than SS_WAIT_MIN. The difference between these times controls how long the screensaver displays before the screen turns off.

Screensaver

MSI Parameter
Function
Configuration
ENABLE_SS
(optional)
Enables or disables the Screensaver.
Yes/No (Default = No).
NB: SS_AUTHCODE is required when ENABLE_SS="Yes".
SS_LOGO
(optional)
By default, the Vibe.fyi logo displays briefly when the Screensaver starts.

To customise the logo, provide a secure public URL to your desired logo which must be in PNG format  (e.g., https://public_website_address/logo.png). [Learn more]
Provide a valid, secure public PNG URL. 
(Default = Vibe logo)
SS_AUTHCODE
Authenticates and enables the Screensaver syncing.
Enter the unique Screensaver auth code generated in the Licence Manager.
DISABLE_SS_INFOBAR
Enables or disables the information bar.
Yes/No (Default = No).
SS_INFOBAR_SYNC_SEC
Sets the time interval for information bar updates.
Enter time in seconds (Default = 30).

Background Wallpaper

MSI Parameter
Function
Configuration
ENABLE_BG
(optional)
Enables or disables the Background Wallpaper.
Yes/No (Default = No).
NB: BG_AUTHCODE is required when ENABLE_BG="Yes".
BG_AUTHCODE
Authenticates and enables the Wallpaper syncing.
Enter the unique Desktop Background auth code generated in the Licence Manager.
BG_IMAGE_INTERVAL_SEC
Sets the time interval for the background image changing.
Enter time in seconds (Default = 30).

Lock Screen

MSI Parameter
Function
Configuration
ENABLE_LS
(optional)
Enables or disables the Lock Screen feature.
Yes/No (Default = No).
NB: LS_AUTHCODE is required when ENABLE_LS="Yes".
LS_AUTHCODE
Authenticates and enables the Lock Screen syncing.
Enter the unique Lock Screen auth code generated in the Licence Manager.
LS_TIMEOUT_MIN
Sets how long the lock screen displays before the PC goes to sleep.
Enter time in minutes (Default = 60).


MSI Deployment

  1. Deploy the MSI in quiet mode (i.e. no user interface nor user interaction) and ensure that your organisation does not have any Group Policy or Intune configuration that prevents our installer from updating the device screensaver settings.
  2. Screensaver & Lock Screen Settings: If you're running the Screensaver and Lock Screen channels, you cannot set the Lock Screen to Slideshow mode as this is not supported in Windows. Doing so will disable the Screensaver and prevent it from functioning as intended.
  3. During deployment, it’s recommended that you set a Group Policy to restrict access to the Screensaver, Lock Screen, and Background settings. This prevents users from altering the settings, ensuring uniformity and adherence to any deployment standards.

Custom Logo

IdeaTo use a custom logo, apply the SS_Logo switch during MSI deployment, or follow the manual steps outlined below after installation.

Logo Design Guidelines

Create your logo as a transparent PNG file and save it as logo.png.
  1. The custom logo should be a square PNG file with a maximum size of 567 x 567 px and a transparent background.
  2. For reference, the default Vibe logo measures 567 x 158 px.

Add Customer Logo for Vibe Screensaver

Option 1: Copy Logo to the Default Folder

Manually copy the logo.png file to the following directory on your computer:
C:\Users\<username>\AppData\Roaming\VibeScreensaver\custom\

Option 2: Download Logo from a Public URL

Use this option to automatically download a custom logo from a specified public URL (website address).
  1. Set the Public URL of the custom logo using the SS_LOGO switch.
  2. The specified URL will be saved in the following registry location: HKEY_CURRENT_USER\SOFTWARE\VibeScreenSaver\CustomLogo
How it works:
  1. The first time the Desktop Player runs, it downloads the logo from the specified URL and saves it locally at: C:\Users[username]\AppData\Roaming\VibeScreensaver\custom\logo_remote.png.
Updating the Custom Logo:
  • To update the logo, simply replace the logo_remote.png file at the public URL.
  • The updated version will be automatically downloaded the next time the Desktop Player checks for it.

Notes:

  • Ensure the logo file at the public URL is accessible and properly formatted.
  • If any issues arise, verify the registry setting and the local directory path.


    • Related Articles

    • Windows Install Guide: Desktop Player (Intune)

      Prerequisites IT / Vibe Admin Read the Technical Requirements & Recommendations guide. Install .Net Framework 4.0 on all target PCs before installing the Vibe.fyi Vibe Desktop Player app. [Learn more] Create the Desktop Channel licences for your ...

    • Windows Install Guide: Desktop Player (Single PC Install)

      Prerequisites IT / Vibe Admin Create the Desktop Channel licences for your Screensaver, Background Wallpaper, Lock Screen or Web Browser. Internal Comms: Follow the Desktop Channel content & playlist setup steps (before running the Vibe Desktop ...

    • Install Guide - Windows

      Prerequisites Review the Install Checklist (read the hardware and network requirements before proceeding). MSI/InTune: Contact your Vibe Support team to request the latest Vibe Desktop player.msi installer. If you're upgrading the Vibe.fyi player app ...

    • Install Guide - LG WebOS2/S3.0

      Read First: Install Checklist - Hardware & Network Requirements Note: it is recommended that you have a Wireless (USB) Keyboard & Mouse to perform this operation. Plug the USB receiver into the USB port on the LG (webOS) display. Supported LG Models ...

    • Troubleshooting: MSI Deployment (v1.1.0)

      Common Deployment Issues If you’re experiencing issues with the deployment of the Vibe Desktop Player, follow these steps to identify and resolve the problem: Check the System Tray: Open the System Tray and ensure the Vibe Player is running. Verify ...