Xibo for webOS

webOS Installation Guide

Xibo for webOS is easy to install and configure and can be up and running in just a few minutes.

Before you begin the installation process, you should first make sure you have fulfilled the minimum requirements below:

Minimum Requirements:

Xibo CMS version 1.8.3 or later.
Your monitor must be listed as a supported model, please check compatibility here
Xibo for webOS software licence required if not on a Plan.

Please note: The use of Xibo for webOS can be included in all Plans for an additional surcharge with no separate licensing requirement. The required Licence information field is completed automatically to connect the Player to the CMS.

Customers with Independent Pricing not on a plan are required to purchase a Xibo for webOS software Licence for each device you intend to run which is then linked to a Licence Pool.

See Player Licensing for further details.

You should also check that you are using the recommended Firmware Version for your Series and Model, please refer to our webOS Firmware Matrix and Firmware Guide.

From version R205, you can pre-prepare the credentials for your CMS using a USB stick. If you would like to set this up, please see the Automating CMS credentials guide before proceeding with the following steps. This will ensure that once you have completed the installation and restarted your monitor, the CMS URL, Key and License Pool code will be automatically entered for you.

Prepare your monitor

Time and Date Settings

It is essential that the correct Time & Date and Time zone are set on your monitor prior to player installation!

Use the Settings button (cogwheel icon) on the remote control to access the General Menu:

Select Time & Date:

Use the drop down to select the correct Time and Date or alternatively ‘Set Automatically’.
Next, click on Time Zone:

Use the drop down to select the Continent, Country/Territory and City.

You can now proceed with the player installation steps!

Install the Xibo for webOS IPK

To install Xibo for webOS, you will need to access the Server or SI Server Settings, depending on the webOS version running on your monitor.

Please follow the appropriate instructions from the options below for the webOS version you are using.

Access Server Settings on webOS 3.0:

From the remote control, press and hold the Settings button until a toast message appears in the upper right corner to notify that your input has been received.
Enter 8080, and press the OK button to open the Settings Menu:

Access SI Server Settings on webOS 3.2 and later:

On your remote control, press the Settings button.
Choose the EZ Setting option.
Select the SI Server Setting option.
Then choose SI Server Setting again on the next page:

Installing the Player

From here, there are two methods for installing the player:

Using Remote URL
Using a USB flash drive

1. Remote URL installation

To remotely install the latest version of Xibo for webOS, set the fields on the Settings menu to the values provided below.

If you would prefer to auto-fill the settings, please follow Option 2: Auto-fill the Settings with USB-flash drive instructions.

Option 1: Manually enter the settings:

Application Launch Mode - Local
Fully Qualified Domain Name - On

Enter the URL to your app package - https://xibo.org.uk/api/downloads/4/latest
Application Type - IPK
Local Application Upgrade - REMOTE

Selecting this option will initiate the download of Xibo for webOS Player to your monitor. This should be the last field you complete.

Option 2: Auto-fill the Settings with USB-flash drive:

If you would rather configure these settings in a text file instead, then you can do so and install those on the monitor via USB flash drive with the following JSON file content:

{ 
   "serverIp":"0.0.0.0",  
   "serverPort":80,  
   "secureConnection":false,  
   "appLaunchMode":"local", 
   "fqdnMode":true, 
   "fqdnAddr":"https://xibo.org.uk/api/downloads/4/latest", 
   "appType":"ipk" 
}

Save the file as scap_installation.json.
Copy the JSON file into the root directory of a USB flash drive.
Insert the USB flash drive into the USB port of your monitor.
Turn on your monitor. The Server Settings defined in the scap_installation.json file will have been loaded onto the monitor automatically.

When the installation is complete, please restart your monitor.

2. USB Installation

If you have a specific version of Xibo for webOS that you wish to install, or you do not have access to the internet to use the remote URL installation method, you can install the player locally via USB:

Download the ipk file for the player version you want to use from here
Rename the downloaded ipk, for example, Xibo_for_webOS_v2_R204.ipk to com.lg.app.signage.ipk and save it in the path specified below on your USB flash drive.

If this path does not exist on your USB flash drive, please create it: [USB_root]/application/com.lg.app.signage.ipk

Insert the USB flash drive into the USB port on your monitor.
Now access the Server Settings menu, as described earlier in this guide.
On the Settings menu, set the fields with the values provided below.

Application Launch Mode - Local Application Type - IPK Local Application Upgrade - USB

Setting Local Application Upgrade to USB will start the copying of the Xibo for webOS Player to your monitor. This should be the last field you complete.

When the installation is complete, please restart your monitor to complete the installation.

Connect to your CMS

After installing the player and restarting your monitor, the Connect to CMS screen will appear.

Enter the following:

CMS URL: The fully qualified address of your CMS installation. For example https://cms.example.org or http://example.org/cms
CMS Key: The secret CMS Key that will authenticate this Display with the CMS.

The secret CMS key can be viewed from the CMS under the Administration menu by clicking on Settingsand the Configuration tab.

This information can be entered manually, or by using one of our alternative methods listed below.

Automating CMS credentials entry using a USB stick

Version R205 and earlier can auto populate CMS credentials credentials by preparing a JSON file.

If you have followed the steps in this guide, you should find that these fields are already filled in.

Use Authentication code to connect to your CMS

If you are using a version 2 R205 Player or later, an additional option is available on the Connect to CMS page from CMS v2.0:

Select the Use Code button to reveal a 6 digit key.
Make a note of this code and log into your CMS.
Go to the Displays menu in your CMS and click the Add Display (Code) button.
Enter the code you received from your Player and click Save.

After a short wait, you should find that an entry for your Player will be created in your CMS.

Once you have successfully entered the credentials for your CMS using one of the above methods, you should see the message: Display is registered and awaiting authorisation from an administrator in the CMS.

Activate your Licence

If you have provided a Licence Pool Code as a Display Setting Profile, or as an entry on the Connect to CMS page, your Player will attempt to contact your license pool and acquire a licence.
If you have not provided a Licence Pool Code, a trial period will begin.

Your player will require a licence before the end of its trial period, or it will no longer receive scheduled events and media.

Display Setting Profiles

Default Profiles have been provided for you.

You only need to create a Display Setting Profile if you want to override these defaults, or if you want to provide your Licence Pool Code to all of your devices centrally.

For more information on available settings, please see webOS Display Profile Settings and the Display Settings sections of the Manual.

Display Authorisation

Before the Player can receive Scheduled Events to display Layouts/Campaigns you will need to Authorise the Display to connect to the CMS.

Log in to the CMS and select Displays from the main CMS menu to see your newly registered Player in the list.
Use the row menu for the new Player and select Authorise from the drop down menu.
Click Yes to confirm the authorisation of the Display.

If you are using a CMS v1.8.7 and earlier, click Edit and select Authorise from the first tab on the form. Click to Save.