Grava, arrenca, mostra — guia d'instal·lació de la imatge de quiosc

Les imatges de quiosc de xiboplayer converteixen qualsevol maquinari en una pantalla dedicada de senyalització digital. Sense experiència en Linux — només cal gravar, arrencar i connectar amb el CMS.

Tria la teva imatge

Descarrega-la des de la pàgina de descàrregues o directament des de GitHub Releases.

Pas 1: Grava la imatge

PC / Portàtil (ISO)

Fes servir qualsevol eina de gravació USB:

# Linux — replace /dev/sdX with your USB device
sudo dd if=xiboplayer-kiosk-*.iso of=/dev/sdX bs=4M status=progress
sync

O bé fes servir Balena Etcher o el Fedora Media Writer.

Raspberry Pi (imatge en cru)

# Decompress and flash to SD card
xzcat xiboplayer-kiosk-*.raw.xz | sudo dd of=/dev/mmcblk0 bs=4M status=progress
sync

O bé fes servir Raspberry Pi Imager — clica «Choose OS → Use custom» i tria el fitxer .raw.xz.

Màquina virtual (QCOW2)

# GNOME Boxes — just double-click the .qcow2 file
# Or with virt-manager:
virt-install --name xiboplayer --memory 2048 --vcpus 2 \
  --disk path=xiboplayer-kiosk-*.qcow2 --import --os-variant fedora43

Pas 2: Arrenca i configura

Encén el dispositiu. El quiosc arrenca dins una configuració guiada:

Configuració del sistema (gnome-initial-setup)

Primer s'executa l'assistent inicial estàndard de GNOME:

1. Idioma — tria l'idioma de la pantalla
2. Teclat — tria la disposició del teclat
3. Xarxa — connecta't a una Wi-Fi o verifica l'Ethernet
4. Fus horari — detectat automàticament o seleccionat manualment
5. Contrasenya — canvia la contrasenya per defecte (recomanat)

Configuració del reproductor (xiboplayer-setup)

A continuació s'engega un assistent natiu:

1. Selecció del reproductor — tria Chromium (recomanat), Electron o arexibo
2. Configuració del CMS — per a arexibo, introdueix l'URL i la clau del CMS directament. Per a Electron/Chromium, ho gestiona la pàgina de configuració web del propi reproductor.

L'assistent desa la teva tria i engega el reproductor automàticament.

Pas 3: Connecta amb el CMS

Electron / Chromium

Després de l'assistent de quiosc, el reproductor obre la seva pròpia pàgina de configuració:

1. Introdueix l'URL del CMS (per exemple, https://cms.exemple.com)
2. Introdueix la clau del CMS (des de CMS → Settings → Display Settings → CMS Secret Key)
3. Clica Connect

arexibo

Les credencials del CMS ja s'han introduït a l'assistent de quiosc. El reproductor es connecta immediatament.

Autoritza al CMS

1. Inicia sessió al teu Xibo CMS
2. Vés a Displays — busca la nova pantalla pendent
3. Clica el menú de la fila → Authorise
4. El contingut apareix en el següent cicle de recollida (en menys de 5 minuts)

Pas 4: Llest

La pantalla ja està en marxa. A partir d'ara:

• S'engega automàticament a cada arrencada — sense necessitat d'iniciar sessió
• Es recupera sola — la monitorització de salut reinicia el reproductor si peta
• S'actualitza automàticament — els paquets s'actualitzen mitjançant el gestor de paquets del sistema
• Reprodueix fora de línia — continua mostrant el contingut emmagatzemat si el CMS cau

Imatges atòmiques — SO immutable

La variant atòmica es construeix sobre fedora-bootc — una base immutable mínima (~1,0 GB comprimida vs 2,5 GB de Silverblue). Només s'inclouen els components necessaris per a la senyalització:

• Base immutable — el SO no es pot modificar accidentalment
• Actualitzacions automàtiques mitjançant bootc switch amb retrocés automàtic en cas d'error
• Natiu de contenidors — construïda com a imatge OCI, convertida a ISO instal·lable amb bootc-image-builder
• Empremta mínima — sense Firefox, sense VLC, sense aplicacions de GNOME no necessàries. Només el reproductor, els còdecs i la sessió de quiosc
• Si una actualització trenca alguna cosa, la versió anterior és disponible al menú d'arrencada

Ideal per a: pantalles desateses en espais públics on importen la fiabilitat i una mida d'imatge petita.

Dreceres de teclat

Un cop en marxa, hi ha les dreceres següents:

Canviar de reproductor

Els tres reproductors estan instal·lats. Pots canviar de reproductor sense reconfigurar el CMS:

# Switch to Chromium (lighter)
doas alternatives --set xiboplayer /usr/bin/xiboplayer-chromium

# Switch to Electron (more features)
doas alternatives --set xiboplayer /usr/bin/xiboplayer-electron

# Switch to arexibo (native Rust)
doas alternatives --set xiboplayer /usr/bin/arexibo

I a continuació reinicia: systemctl --user restart xibo-player.service

Resolució de problemes

Passos següents

• Connectar una pantalla — guia detallada per connectar amb el CMS
• Referència de configuració — totes les opcions de configuració
• Resolució de problemes — més solucions
• Sincronització multi-pantalla — configura panells de vídeo