Xibo for Android is released as a standalone “APK” installer file and can be downloaded from our shop in the Downloads section. Xibo for Android is easy to install and configure and can be up and running in just a few minutes.
Please note: Xibo for Android requires a Xibo for Android software licence for each device you intend to run which is then 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 device
- Downloading Xibo for Android APK
- Installation of Xibo for Android APK
- Connecting to your CMS
- Authorising your Display
- Activating your Licence
Prepare your device
Xibo for Android is a non-market Android application, which means the device will need to be configured to allow the installation of applications from unknown sources. This setting is found in the “Security” or “Applications” section of the standard Android “Settings tab”.
This setting should be disabled after installation unless auto-update is required (see Rooted Devices below for further information).
Enable the Wireless Adaptor
Xibo for Android will try to get the MAC Address of your Wireless Adaptor and record it in your CMS, but it can only do that if the Wifi Adaptor is enabled.
The first time you connect the Display you will need to have your Wireless Adaptor enabled. It is best to do this prior to installation so that you don’t have to leave Xibo for Android during configuration. After your Display is connected to the CMS you can turn the Wireless Adaptor off (unless you are using it of course!).
Date and Time
Confirm that the Date / Time and Timezone information are correctly set on the device. This information is used by Xibo for Android for time sensitive scheduling as well as for the 14-day trial.
Take a look at the Helper Command that can be used to change time zone on Android:
Helper Command to change Time zone
Please note: If this is incorrectly set during installation your 14-day trial of Xibo for Android may expire sooner than it should.
Download and Install the Xibo for Android APK
Please note: From 1.8 R101 Xibo for Android requires at least a 4.4 based Android device.
Xibo for Android is released as an APK file which can be opened and installed by the Android OS. You will need to download or transfer the latest Xibo for Android APK release file onto your device for installation. The easiest way to do this is to select and download the latest release for your device directly from here: Download Xibo for Android
If you’re using DS Devices DSC-J18 or J19 hardware (but NOT the DSCS9), then you should download the latest DS Devices version from the same link. It has tighter integration with the device hardware and gives “root” access without needing to first root the device.
If you are using a DSCS9 and want to install a different version of the Xibo for Android Player, please use the following guide: Install a White Label or a different Player version on a DSCS9
To download and install to use Xibo for Android, you must agree to the End User Licence Agreement.
With the above preparation complete you should now have a device which can install non-market applications, with the Wifi Adaptor enabled, the correct Date/Time/Timezone and the latest Xibo for Android APK file downloaded onto the device.
Install the Xibo for Android APK
Open the APK file and click to install. Xibo for Android may require a number of permissions, which we have tried to keep to a minimum. Please accept any listed permissions and allow the installation to complete. Xibo for Android will now be available in your app drawer.
Connect to your CMS
Open Xibo in the app drawer after installation and connect the Display by either:
a) Use Code (available from v2 R204 and later for supported Android APK files)
b) Manual Configuration (CMS Address and Key)
Click on Use Code to show a 6 character Activation Code. Ensure that the form remains open until you have entered the code in your Displays admin page and the Player launches automatically. Closing this form will hide the code and will stop the configuration.
In the CMS navigate to the Displays page and click on Add Display (Code).
- Enter the Activation Code as shown on the Player screen.
Once successfully configured, the Activate Player page will automatically close.
The Display will be registered and awaiting authorisation. Follow the Display Authorisation section below.
- CMS Address - Enter the fully qualified address of your CMS installation. For example https://cms.example.org or http://example.org/cms
- CMS Key - The secret Key that will authenticate this Display with the CMS.
- Connect CMS - A message will be shown for the first successful connection, “Display is registered and awaiting authorisation from an administrator in the CMS”.
Assuming there are no errors with the communication between the CMS and the Player, the Display will be registered and awaiting authorisation as detailed in the Display Authorisation section below.
The CMS Key can be viewed from the CMS under the Administration menu by clicking on Settings and navigating to the Configuration tab.
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.
Click Yes to confirm the authorisation of this Display.
CMS version 1.8.7 and earlier, click Edit and select Authorise from the first tab and Save.
At this point, you may want to select a Default Layout for your new Player to run.
Activate your Licence
On your Android display, use the configuration menu by accessing the 3 dot menu button in the top right of your device and click on Connect. You will be asked to confirm your CMS address and CMS Key and to Connect.
CMS 1.7 or later
If your CMS is 1.7 or later and 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 on the device. If you are using the trial you can elect to “Skip” this step
CMS 1.6 or earlier
If your CMS is 1.6, you will be taken to a page asking for your Licence Pool email address on the device. If you are using the trial you can elect to “Skip” this step.
After either activating your licence or skipping the trial, Xibo will start fully and download its content from the CMS.
If you are connected to a 1.7 CMS or later then the majority of the settings are available for configuration in the CMS itself by creating a Display Setting Profile for Android (which is where you can enter your Licence Pool email address).
The configuration menu is accessible from the Player’s action bar menu at the top of the screen, under the 3 dot menu button.
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.
An Android device that has been rooted can take advantage of the auto-update functionality (available in 1.7 R53 and later).
Please note: If you’re using DS Devices hardware and have installed the DS Devices specific APK (as described in the installation steps above) then there is no need to root the device to take advantage of the automatic upgrade. You will need to ensure however that you always install/upgrade with the DSDevices specific version of Xibo for Android.
- Xibo CMS 1.6.1 or higher
- Xibo for Android R53 or higher
- Android 4.1 or higher | Android 4.4 or higher from 1.8 R101
- Root access to the device (with SU or SuperUser installed)
Xibo for Android does require a number of permissions, which we have tried to keep to a minimum. Please accept the listed permissions and allow the installation to complete. Xibo for Android will now be available in your app drawer as normal.
Preparing the device
The device should be prepared with root access and a suitable root manager application such as SuperUser. It should also have Xibo for Android R53 or higher installed and configured. For further information and general instructions, please see Rooting a Device.
Granting Root Access
The Xibo application should be granted root access to the device, which is done from the Settings menu.
Clicking or pressing on “Check root is available” will open a popup window, as seen below will ask for a confirmation. At this point, Xibo will need permanent access to root so that no further user interaction will be required during the update process.
If the popup window does not open it means that root access is not configured correctly on the device.
After selecting “allow” a message will appear saying that super user access has been granted and the configuration for auto-update on the Player is complete.
If you are using SuperSu you should ensure that the “Re-authentication” setting is disabled. Failure to disable this setting will mean that the application will lose root access after any upgrade.
Setting an upgrade window
If you want to set a particular time for the player application to upgrade you will need to create a Display Settings Profile in the CMS and assign it to the Display.
For further information regarding Upgrades, please see Upgrading Xibo for Android.