webOS Installation Guide

Xibo for webOS requires Xibo CMS version 1.8.3 or later.

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

Supported monitor models

To ensure that you are using the recommended Firmware Version for your Series and Model, please refer to our webOS Firmware Matrix.

Please note: Xibo for webOS requires a Xibo for webOS software licence for each webOS Display you intend to run which is linked to a “Licence Pool email address”

This guide will take you through each step in detail for the required installation, which includes the following stages:

  • Preparing your monitor
  • Installation of Xibo for webOS IPK
  • Connecting to your CMS
  • Activating your Licence
  • Authorising your Display

Prepare your monitor

It is vital that the correct date, time and timezone are set on your TV prior to installation.

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

click on 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.

Access Server Settings webOS 3.0

  • On 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 Server Settings webOS 3.2 and later

  • On the remote control, press the Settings button to open the Settings Menu.

Install the Xibo for webOS IPK

From here, there are two ways in which the Player can be installed; Using the Remote Server or by using a USB flash drive. Both options are explained in detail below:

Option 1 - Remote URL installation

On the Settings menu, set the following fields (as marked in the above images) to the values provided.

  • A) Application Launch Mode - Local
  • B) Fully Qualified Domain Name - On
    Enter the URL to your app package - https://xibo.org.uk/api/downloads/4/latest
  • C) Application Type - IPK
  • D) Local Application Upgrade - REMOTE

This action initiates webOS Signage to download the app from the given URL.

2.2 Auto-Setting 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 the signage device
  • Turn on your signage device. The Server Settings defined in the scap_installation.json file will have been loaded onto the device automatically.

Option 2 - USB Installation

  1. Rename the downloaded ipk, for example, Xibo_for_webOS_v1.8_R7.ipk to com.lg.app.signage.ipk and put in a USB flash drive in the path specified below. If such path does not exist in your USB flash drive, create one. [USB_root]/application/com.lg.app.signage.ipk
  2. Insert the USB flash drive to the USB port of your signage device.
  3. On your signage device, enter the Server Settings menu:

- webOS 3.0

  • On 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 .

- webOS 3.2 and later

  • On the remote control, press the Settings button to open the Settings Menu .

  1. On the Settings menu, set the following fields with the values provided. The required fields are marked with corresponding letters as per the above images for further guidance:
  • A: Application Launch Mode - Local
  • B: Application Type - IPK
  • C: Local Application Upgrade - USB
    This action initiates webOS Signage to copy the app from the USB flash drive to the signage device’s local storage.

Once completed, reboot the signage device.

Connect to your CMS

After completing the installation, the Settings screen will open on the first Player start to enter the following:
CMS Address This is 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.

This key can be viewed from the CMS under the Administration menu by clicking on Settings and the Configuration tab.

The Settings screen is also accessible using the top navigation menu.

The following message will be shown for the first successful connection, “Display added and is awaiting licensing approval from an administrator”.

Assuming there are no errors with the communication between the CMS and the Player, the Display will be registered and awaiting authorisation.

Activate your Licence

If you have provided a Licence Pool email address as a Display Setting Profile in the CMS, Xibo will start immediately and download its content from the CMS. If you have not provided a Licence Pool, you will be taken to a page asking for this information. If you are using the trial you can elect to “Skip” this step.

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 email address 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 and display your Layouts you will need to Authorise the Display to connect to the CMS.

Log into your CMS and click on Displays from the main menu to see your newly registered Player in the list.

Click the row-menu for this Player and select Authorise from the list.

authorise_row_menu

Click Yes to confirm the authorisation of the Display.

CMS version 1.8.7 and earlier, click Edit and select Authorise from the form on the first tab, Save.

At this point, you may want to select a Default Layout for your new Player to run.

1 Like