Xibo for Android is released as a standalone "APK" installer file and can be downloaded from our downloads section or from our website. It is easy to install and configure and can be up and running in a few minutes. We will go through each step in the installation in detail, but an overview is as follows:
- Prepare your device
- Download and Install the APK
- Connect to your CMS
- Optionally adjust the default settings
Upgrading? Check our upgrade guide.
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" section of the standard Android settings tab.
This setting should be disabled after installation unless auto-update is required (see rooted devices below).
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 before installation so that you don't have to leave Xibo for Android during the 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 time zone information are correctly set on the device. This information is used by Xibo for Android for time sensitive scheduling and for the 14 day trial.
If the Date/Time is incorrect during installation your 14 day trial may expire sooner than it should.
Download and Install the Xibo for Android APK
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 release onto your device for installation. The easiest way to do this is to open this link directly on the device and download the latest release.
If you're using DSDevices hardware, then you should download the latest DSDevices version from the same link. It has tighter integration with the device hardware and gives "root" access without needing to first root the device.
Now that the above preparation is complete you should have a device which can install non-market applications, with the wifi adaptor enabled, the correct date/time and the latest Xibo for Android APK file sitting somewhere on the devices storage.
The only remaining step is to open the APK file and allow the Android package manager to install the application.
Xibo for Android does require a number of permissions - we have tried to keep these to a minimum. Please accept the permissions listed and allow the installation to complete. Xibo for Android will now be available in your app drawer as normal.
Connect to your CMS
When you first open Xibo you will be taken to a connection wizard which asks for your CMS Address and Secret Key. Enter these details and click connect. You should expect the first successful connection to report "Display waiting licensing approval by an administrator".
Log into your CMS using the browser (either on the Android device or on your PC/Mac) and navigate to the Display Page. The new display will be listed, click edit and select "Display licence?" change the value to "yes" as shown below.
On your Android display, click Connect again and the wizard should complete and take you to the next step.
Next step - if your CMS is 1.6 or earlier
If your CMS is 1.6, you will be taken to a page asking for your licence pool email address. This is your Xibo for Android software licence and is required after the 14 day trial period has expired. If you are using the trial you can elect to "Skip" this step.
After either activating your licence or skipping, Xibo will start fully and download its content from the CMS.
Next step - if your CMS is 1.7 or later
If your CMS is 1.7 and you have provided a licence pool email address as a settings profile in the CMS, Xibo will start immediately and download its content from the CMS. If you have not provided a licence pool, Xibo will ask for one in the same manner as described above in 1.6 or earlier.
The configuration menu is accessible from the top menu (called the action bar) under the 3 dot menu button.
If you are connected to a 1.7 CMS then the majority of the settings are available for configuration in the CMS itself by creating a Display Profile for Android. This is also where you enter your licence pool email address.
Sensible defaults have been provided and you only need to create a 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.
To create an Android display profile:
- Open the CMS and navigate to the Display Settings Page.
- Click Add Profile and select Android from the player type selector.
Once you have a profile created, you can edit it and adjust any configuration options you need, then click Save.
More information on the settings available can be found here and the Display Profiles topic of the Xibo Manual.
An Android device that has been rooted can take advantage of the auto-update functionality available in 1.7 R53 and later.
Note that if you're using DSDevices hardware and have installed the DSDevices 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
- Root access to the device (with SU or SuperUser installed)
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 rooting advice and general instructions 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 open and 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. For further information on the upgrade process see: Upgrading Xibo for Android.
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.
We hope you find the installation easy - if not please let us know what you had trouble with by submitting a ticket.