xiboplayerxiboplayer
EN

Quick Start

Get your first xiboplayer display up and running.

Prerequisites

  • A Xibo CMS instance (self-hosted or cloud at xibosignage.com)
  • A Linux machine, Raspberry Pi, or any device with a web browser

Install

Option A: Package manager (Fedora/Ubuntu)

# Add the xiboplayer repository
sudo dnf install https://dl.xiboplayer.org/rpm/fedora/43/noarch/xiboplayer-release-43-7.fc43.noarch.rpm

# Install the Electron player (recommended)
sudo dnf install xiboplayer-electron

# Or the Chromium player (lightweight)
sudo dnf install xiboplayer-chromium

Option B: Kiosk image (dedicated display)

Download a pre-built image from the Downloads page. Flash it to a USB drive or SD card, boot, and the player starts automatically.

Option C: PWA (any browser)

Deploy the PWA to your web server and open it in any modern browser. See the PWA player page for details.

Configure

  1. Launch the player — it opens the setup page
  2. Enter your CMS URL (e.g., https://your-cms.example.com)
  3. Enter the CMS Key (found in CMS → Settings → Display Settings → CMS Secret Key)
  4. Click Connect

Authorize in CMS

  1. Log into your Xibo CMS
  2. Go to Displays — you'll see a new pending display
  3. Click the row menu → Authorise
  4. The player starts showing the default layout

Next steps