Xibo for Linux Installation
- Xibo for Android
- Install a White Label or a different Player version on a DSCS9
- CEC Screen Power on/off with DSDevices
- Hardware Recommendations
- Philips Signage SoC Monitors
- Managing Storage on the Android Device
- Player Settings
- Players without an Internet Connection
- Remote Administration with SS Helper
- Restart Rooted Device with a Shell Command
- Rooting a Device
- Running Xibo for Android
- Resolving Common Issues
- Error shown when I try to licence my Player?
- Player not updating from the CMS?
- I can see my Licence entry but the Player appears unlicensed?
- Error message - Player is missing dependencies
- My scheduled Layouts are not working?
- Layout won't play? Splash screen plays?
- Watchdog error message
- Troubleshooting for Administrators
- Audit Trail
- Log Information
- Player Logs
- Getting the Player Status
- Can I use the Xibo name / logo?
- Can I run a Xibo Player on Raspberry Pi?
- How can I increase the upload file size limit?
- How do Players communicate with the CMS?
- How many displays can Xibo support?
- How do I reset the Xibo_admin account password?
- Power On/Off for Players
- Testing with Xibo
- Why do I need a Default Layout?
- Xibo for Android FAQ's
- Autoplaying Embedded Youtube Videos
- Closing to Home screen
- Displaying Images
- Embedded TV
- External SD card not listed when running Banana-Pi
- Helper Command to change Time zone
- HTML5 Video
- Memory Notifications
- Menu not accessible
- SSL Support
- Using Portrait Displays
- Video wont play properly
On this page
Xibo for Linux Installation
The Xibo for Linux Player is released as a snap package, distributed via snapcraft. This offers a clean, dependency free installation, as well as the potential for automatic upgrades in the future.
There are 4 steps to follow:
- Preparation of the CMS
- Installation of the Player
- Connection of your Player to the CMS
- Authorisation of your Display with the CMS
If you have a 1.8.12 or later CMS, then you can connect the Player directly to that as it already has support for Linux Players. You may need to create a Display Settings Profile for the Linux Player ahead of connecting your first Linux Player.
Not all of the settings in the Display Settings Profile will work at present, but we’ve included them now in readiness for them being fully implemented into the Player.
If you’ve never run the test Player before, or you previously removed the snap package, then to install the Player, simply run:
snap install xibo-player --channel=stable
The Player will be installed without affecting any other software you might have installed on your machine.
You may also visit: https://snapcraft.io/xibo-player or use the button below.
You can check to see what version of the Player you have installed by running
You should see an entry in the output like this:
Name Version Rev Tracking Publisher Notes xibo-player 1.8-beta1 16 beta xibosignage -
To upgrade from the 1.8-alpha6 or later release:
snap refresh xibo-player --channel=beta
You may find that snapcraft has automatically upgraded your
You cannot upgrade to 1.8-alpha6 from older alphas, so if you previously installed 0.3.3a, 0.4a or 0.5a and haven’t removed it, then
snap remove xibo-player-test
After removing the older release, continue to install the Xibo Player.
Newly installed Players must be configured and registered with the Xibo CMS before they can be used using the Player Options.
Most of the Player options are set on the CMS and delivered over the network to the Player. This keeps the Player configuration to a minimum on each new installation.
To run the Player select Xibo Linux Player from the desktop/app drawer or open a terminal and run
If running for the first time, an options form will open asking for your CMS details. Before any options can be sent from the CMS it is necessary to register the Display with the CMS instance. This can be done by completing the necessary fields using the Connect tab as pictured below:
CMS Address This is the fully qualified address of your CMS installation. For example
https://cms.example.org or http://example.org/cms
Key The secret CMS Key that will authenticate the Display with the CMS.
Local Library Please choose an appropriate local library for the Player to store its files.
On the Advanced tab a unique Display ID has been generated for you.
Once all the above fields have been completed, the Save button should be pressed. At this point, the message window will update with the status “Saving with CMS… Please Wait…”
The Player will register with the CMS. Press Exit to quit and then launch the Player again.
Before the Player can receive Scheduled Events and display your Layouts you will need to Authorise the Display to connect to the CMS.
Click on “Display Admin” on the Player Options window or log in to the CMS web interface. 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 and click Yes to confirm the authorisation of this Display.
At this point, you may want to select a Default Layout for your new Player to run
Once registered, the Player will be given a default Display Setting Profile. For further information see the Display Settings section.
You can now launch the Player from the Player Options. It should display the Xibo Splash Screen while the Default Layout and its media contents (and anything else you have scheduled) are downloaded. The Player will then begin playing Layout content.
You can safely delete the files the Player created in your temporary directory, and if you want to remove the Player from your system, simply run
snap remove xibo-player