Xibo for Linux Installation

Xibo for Linux 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.

Prepare your 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 implemented into the Player.

Install the Xibo 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.

Get it from the Snap Store

Upgrading from an older release

You can check to see what version of the Player you have installed by running

snap list

You should see an entry in the output like this:

Name                  Version         Rev   Tracking  Publisher     Notes
xibo-player           1.8-beta1       16    beta      xibosignage   -

Upgrading from 1.8-alpha6 or later

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 xibo-player snap.

Upgrading from earlier than 1.8-alpha6

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.

Run the Player

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. To get back to this options form in the future run xibo-player.options.


The CMS Address and Key are the ones you would normally use to register Players with the CMS. 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.

The Player will register with the CMS. Press Exit to quit and then launch the Player again.

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.

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

Display Setting Profiles

Once registered, the Player will be given a default Display Setting Profile. For further information see the Display Settings section.


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