Upgrade Branding Player for XPression 2.1.x.x to Branding Player 3.1.x.x

Owned by Danny Ljubisic, created
Last updated: Jun 07, 2023
3 min read

This upgrade involves more than just running an updated executable. The 3.1.x.x Branding Player no longer communicates to the XPN API as did the deprecated 2.1.x.x Branding Player. Below are instructions/steps on how to upgrade your Branding Player.

Overview

The diagram below is a high level, visual outline of this upgrades changes.

Prerequisites

These instructions are based on upgrading an existing, working setup of Branding Player for XPression (ie. some steps for new installations may be omitted). Also, Ticker Player for XPression is expected to be installed and working.

Download the latest version of Branding Player from here: http://bannisterlake.com/dl/installs/Chameleon/_branding/

 

  1. Uninstall “Branding Player for XPression” from your system using either Windows Control Panel or the Add/Remove:

     

     

  2. Install “BrandingPlayerInstaller3.x.x.x.msi” and be sure that you are using the installer that does not have ‘XPR’ in the name. Use all the install’s defaults until complete.

  3. Typical installations will have 2 separate folders for keeping XPression projects: Branding & Ticker. With this upgrade only 1 XPression project folder supported. As such it is recommended to copy all XPression project folder from the Branding folder over to the Ticker folder.

     

  4. Launch the Ticker Player for XPression and go to the ‘Settings’ tab on the Player. Ensure that the API settings are enabled. Also, make note of the ‘Project Folder’ path and ‘API Port’ assignments as these will need to be copied over to the Branding Player preferences.

     

  5. Launch the newly installed ‘Branding Player’ from the desktop shortcut and when prompted, click on ‘Yes’ to configure the Player’s preferences:

     

  6. Server settings dialog follows. The defaults here should work, however, if any adjustments are necessary they should only be to the “Flow URL” and/or the UserID fields and these should match your Ticker Player setup.

     

  7. Select your Channel(s) and click okay. The Branding Player now supports multiple channels. If you receive any errors or no channels in this list, first confirm you have the pre-requisites complete. Channels are defined in the Flow or browser interface. Adjust your Logos folder path if necessary.

     

  8. On the Branding Player go to the “File->Channel Preferences” menu item.

     

  9. At a minimum, the channel needs to have a Program IP & Port defined. The Port must be the same Port number/value as found in the Ticker Player API setting. Optionally, Preview outputs can be configured here as well. Click ‘OK’ once complete.