PIXLOVADocumentation

Linux

Installer le Player Pixlova sur un PC Debian ou Ubuntu, en mode kiosque ou dans une session graphique.

Le Player Linux s’installe sur un PC branché à un ou plusieurs écrans. Il conserve ses contenus sur le disque, continue de diffuser sans Internet et se met à jour seul.

Pour un Raspberry Pi, utilisez plutôt l’image prête à l’emploi : voir Raspberry Pi.

Prérequis

  • Un PC x86_64 sous Debian 13 ou Ubuntu 24.04.
  • Les bibliothèques d’affichage WebKitGTK 4.1 et GTK 3, ainsi que GStreamer avec gst-libav pour lire les vidéos H.264.
  • Pour le mode kiosque : le paquet cage (sudo apt-get install cage).
  • Un accès administrateur (sudo).
  • Une connexion à Internet pour l’appairage et le premier téléchargement des contenus.

Le Player est livré sous forme de paquet (archive .tar). Téléchargez-le depuis la page de téléchargement, aussi accessible dans l’app quand vous ajoutez un écran.

Choisir le mode d’affichage

ModeÉcransCe que fait l’installation
Kiosque (--kiosk)Un seulLe PC démarre directement sur le Player, en plein écran, sans bureau.
Session graphiqueUn ou plusieursLe Player s’ouvre dans la session graphique du compte pixlova, dont l’ouverture automatique reste à configurer.

Installer le Player

  1. Copiez le paquet sur le PC et extrayez-le dans un dossier.

  2. Ouvrez un terminal dans ce dossier.

  3. Lancez l’installation :

    • en mode kiosque :

      sudo ./install.sh --kiosk
    • en session graphique :

      sudo ./install.sh
  4. En session graphique seulement : configurez l’ouverture de session automatique du compte pixlova dans votre gestionnaire de connexion (par exemple l’option AutomaticLogin de GDM).

  5. Redémarrez le PC.

L’installation crée le compte système pixlova, installe le Player et ses services, puis active la mise à l’heure automatique (NTP) si aucune n’est déjà en service. Une horloge en retard retarde d’autant le démarrage des nouveaux programmes : si l’heure du PC est gérée autrement, ajoutez l’option --no-time-sync.

Le Player se connecte par défaut au serveur Pixlova. N’utilisez l’option --api-url que sur indication de Pixlova.

Relier le PC à un écran

Au redémarrage, chaque sortie vidéo affiche son propre code d’appairage au format XXXX-XXXX, valable 5 minutes et renouvelé tout seul.

  1. Dans Pixlova, ouvrez Écrans › Tous les écrans, cliquez sur + Ajouter un écran, puis saisissez le code dans Code affiché sur l’écran (voir Écrans).
  2. Programmez des contenus pour cet écran.

L’écran reste lié à la sortie dont vous avez saisi le code. Avec plusieurs écrans, répétez l’opération pour chacun.

Tant que le serveur Pixlova n’est pas joignable, le Player affiche « Connexion au serveur Pixlova… » avec le nom de l’appareil et ses adresses IP, au lieu d’un code.

Langue

Les écrans d’information du Player (connexion, appairage) suivent la langue du système, définie dans /etc/locale.conf ou /etc/default/locale.

Mises à jour

Le Player vérifie toutes les heures si une nouvelle version est publiée et l’installe seul. Si elle ne démarre pas correctement, il revient à la version précédente. Vous pouvez aussi déclencher la mise à jour depuis la carte Version du Player de sa page dans Pixlova (voir Players).

Diagnostic

Pour un technicien, ces commandes donnent l’état du Player :

sudo -u pixlova /var/lib/pixlova/versions/active/pixlova-agent diagnose   # rapport sans secret
journalctl -u pixlova-launcher -f                                         # journaux du Player

Les contenus et l’identité du Player sont conservés dans /var/lib/pixlova.

En cas de problème

Consultez la page Dépannage.

Sur cette page