Installazione del digital signage su Raspberry Pi.

Che cosa abbiamo fatto

• Basata su Raspberry Pi OS a 64 bit.
• Abbiamo fatto partire l’app come servizio di sistema, con la possibilità di passare in modalità kiosk senza interfaccia desktop.
• Abbiamo configurato il firewall per bloccare tutte le richieste in ingresso.
• Abbiamo disattivato lo screen saver.
• Abbiamo configurato mouse e barra delle applicazioni perché si nascondano da soli
• Abbiamo installato il software del player (se vuoi solo il software del player, puoi scaricare l’ultimo AppImage ARM64).
• Abbiamo installato il pacchetto cec-utils per il supporto HDMI-CEC

Guida all’installazione di Raspberry Pi 5 e 4 (modalità kiosk disponibile)

• Scarica l’immagine per Raspberry Pi 5 e 4. (Basata su Debian 12 – bookworm, kernel 6.6.74, immagine del 5 marzo 2025)
• Decomprimi l’archivio zip.
• Scrivi il file .img sulla scheda SD con balenaEtcher.
• Inserisci la scheda SD nel Raspberry Pi e accendilo.
• NB! Al primo avvio il file system viene espanso e il dispositivo si riavvia durante il processo.
• All’avvio parte la nostra app. Premi «Esci» in alto a destra
• Collegati a internet (in alto a destra compare una barra degli strumenti)
• Apri Menu (in alto a sinistra) -> Preferences -> Raspberry Pi Configuration.
  • Scheda System: la password predefinita è raspberry, ti consigliamo di cambiarla!
  • Scheda Localization: imposta la lingua e il fuso orario giusti.
• Avvia l’applicazione del player dal desktop.

Guida all’installazione di Raspberry Pi 3

• NB! Il Raspberry Pi 3 esegue l’app piuttosto lentamente, ma si può usare per contenuti semplici.
• Scarica l’immagine per Raspberry Pi 3. (Basata su Debian 12 – bookworm, kernel 6.1.0, immagine del 24 luglio 2024)
• Decomprimi l’archivio zip.
• Scrivi il file .img sulla scheda SD con balenaEtcher.
• Inserisci la scheda SD e accendi il dispositivo.
• NB! Al primo avvio il file system viene espanso e il dispositivo si riavvia durante il processo.
• All’avvio parte la nostra app. Premi «Esci» in alto a destra
• Collegati a internet (in alto a destra compare una barra degli strumenti)
• Apri Menu (in alto a sinistra) -> Preferences -> Raspberry Pi Configuration.
  • Scheda System: la password predefinita è raspberry, ti consigliamo di cambiarla!
  • Scheda Localization: imposta la lingua e il fuso orario giusti.
• Avvia l’applicazione del player dal desktop.

Nei nostri test il dispositivo si scalda in fretta, soprattutto dentro un contenitore. Quando gira caldo può danneggiare i componenti e le prestazioni calano. Ti consigliamo un dissipatore sul chip. Lo trovi su eBay o in un negozio di componenti elettronici vicino a te.

Se non usi l’alimentatore ufficiale, assicurati che l’adattatore sia abbastanza potente:

• Almeno 2 A per i dispositivi del modello 3 (meglio 2,5 A)
• Almeno 3 A per i dispositivi del modello 4

Il Raspberry Pi è probabilmente l’opzione più economica per far girare i nostri player su software open source (c’è anche Linux). Essendo un dispositivo di fascia bassa, ha però alcuni limiti:

• La maggior parte degli effetti di transizione tra diapositive va a scatti, quindi non consigliamo di aggiungerli.
• Le animazioni degli elementi vanno a scatti; sono pensate fin dall’inizio per player più potenti.
• Le schede SD si consumano: a differenza della memoria integrata, una scheda SD si può scrivere solo un numero limitato di volte. Ti consigliamo una scheda SD di buona qualità e ad alta velocità, per ridurre i problemi nel tempo.

I modelli 4 e 5 dichiarano entrambi il supporto del 4K, ma la capacità di riprodurre video 4K è limitata a certi codec e certi lettori. Abbiamo provato diversi lettori e VLC ha il miglior supporto codec per il 4K, ma anche con VLC il supporto era molto limitato (soprattutto H265 sotto i 30 fps). Abbiamo anche visto che VLC non era stabile nella riproduzione ripetuta: a volte il lettore partiva ma il video non si vedeva, e VLC faceva anche cadere l’intera sessione desktop. Per questo, al momento, non possiamo offrire una riproduzione 4K fluida sul Raspberry Pi e consigliamo di far girare i dispositivi a 1920×1080.

Le opzioni si aprono dal player oppure nelle impostazioni del tuo player.

• Apri lettore all’avvio - Attiva questa opzione perché la nostra app parta all’accensione del player, per esempio dopo un’interruzione di corrente.
• Sempre in primo piano - Dice al sistema operativo di tenere la finestra della nostra app sopra le altre. Così popup e notifiche non compaiono sopra.
• Mostra barra del menu in alto - Attiva se vuoi che la barra in alto compaia quando muovi il mouse o usi il telecomando del player. Disattiva se vuoi un’esperienza da totem, in cui non si esce dall’app con il pulsante di uscita sulla barra. Il menu resta raggiungibile con il comando «Ctrl + O».
• Ottimizza per il touch screen - Attiva se vuoi usare l’app su uno schermo touch. L’impostazione adatta il funzionamento dell’app allo schermo touch.
• Analitica - Attiva se ti servono i dati di analitica di questo player. Leggi di più sull’Analitica
• Orientamento di visualizzazione - Usala solo se il sistema operativo del player non permette di cambiare l’orientamento: consigliamo di farlo a livello di sistema operativo. Puoi scegliere Ritratto (orario) e Ritratto (anti-orario).
• UserAgent - Lo UserAgent è un testo con cui i browser si presentano al server web. Alcuni siti mostrano la versione mobile, anche se il sito è su uno schermo grande. Con questa opzione puoi aggirare il problema e usare lo UserAgent di un computer desktop. Puoi scegliere Default, Mobile, Desktop o Custom.
• Ricarica lettore ogni giorno alle - È buona pratica svuotare la cache del player una volta ogni 24 ore. Qui imposti un orario comodo, per esempio di notte, quando nessuno guarda la TV.
• Display acceso / Display spento – Accende e spegne lo schermo in base a una programmazione. (Leggi come accendere e spegnere la TV)
• Tag - Se usi i tag, li trovi elencati qui. Puoi anche cercarne uno e aggiungerlo.
• Elimina cache - Se devi svuotare la cache a mano, lo fai da qui. Per esempio, se cambi spesso i contenuti e qualcosa non funziona come ti aspetti, svuotare la cache aiuta: toglie i dati vecchi dalla memoria del player.
• Trasferisci schermo - Sposta gli schermi da un team all’altro senza eliminarli né ricollegarli. Scopri come trasferire uno schermo
• Ricarica - Ricaricare il player è simile a svuotare la cache. In più, la ricarica chiude e riavvia l’app.
• Stato - Lo stato dice se l’app è collegata al cloud. Verde: sei collegato. Rosso: non sei collegato. Se vedi lo stato rosso, controlla internet e il Wi-Fi del player.
• Ora del dispositivo - L’ora del dispositivo è data e ora del player. Se è sbagliata, lo è anche nella nostra app e quindi tutta la programmazione legata all’ora va fuori fase: correggi l’ora nel sistema operativo del player se hai problemi.
• Risoluzione - È la risoluzione secondo il sistema operativo del player. Se il sistema dice che sta girando in HD, i contenuti sulle TV vengono ottimizzati per l’HD. Tieni presente che molti dispositivi pubblicizzati come 4K decodificano il video in 4K ma eseguono le app a una risoluzione più bassa. Puoi quindi vedere una risoluzione più bassa nella nostra app, ma un video 4K viene comunque riprodotto in 4K. Se vedi una risoluzione più bassa, installa un’app di terze parti «resolution checker» sul dispositivo per confermarla anche da un’altra app.
• Versione - È la versione della nostra app.
• UID Schermo - Detto anche UID: l’identificativo univoco del player.
• Utilizzo del disco - Indica quanti dati sono stati usati nella memoria del player. Ti consigliamo di non superare l’80% dello spazio.
• Margini dello schermo - Se hai uno schermo LED, un videowall o una TV più vecchia, potresti dover regolare i margini perché coincidano con la TV e i contenuti.
• Browser - Da qui apri facilmente il browser usato dall’app per controllare contenuti, connessione e altro.
• Reset - Se devi scollegare il player o collegarlo a un altro account, usa Reset.

Il dispositivo dice che è offline

Se il dispositivo è offline, non è connesso a internet e quindi non può raggiungere il nostro cloud di digital signage. Vedi la guida Schermo offline.

La risoluzione non è corretta.

Il digital signage su Raspberry Pi prova a impostare la risoluzione da solo; a volte, però, non rileva quella migliore. Puoi impostarla a mano in Menu -> Preferences -> Display Settings.

Se lì non trovi la risoluzione che vuoi, altre opzioni di configurazione del display sono in Menu -> Preferences -> Raspberry Pi Configuration -> Display -> Resolution.

Come metto la TV in standby di notte?

Questa funzione invia un comando alla TV via cavo HDMI, per metterla in standby e risvegliarla al mattino. Il digital signage su Raspberry Pi resta acceso per tutta la notte.

NB! Raspberry Pi 4 e 5 hanno due porte micro-HDMI; i comandi HDMI-CEC escono solo dalla prima porta (quella accanto alla porta di alimentazione USB-C). Se usi l’altra porta, i comandi non funzionano.

Se hai scaricato la nostra immagine per Raspberry Pi dopo aprile 2021, tutti i pacchetti necessari sono già nell’immagine e puoi saltare il primo passaggio, l’installazione di cec-utils.

• Installa il pacchetto cec-utils: sudo apt-get update && sudo apt-get install cec-utils (Ubuntu)
• Assicurati che il CEC sia attivo sulla TV. I produttori danno nomi diversi alla stessa funzione.
  • Tizen: Menu -> System -> General -> Anynet+
  • Philips: Home -> Settings -> TV Settings -> Easylink
  • LG: Settings -> All Settings -> General -> SIMPLINK
  • Sony: Options (On the remote) > Settings > Inputs > External inputs > BRAVIA Sync settings
  • Altre marche: la maggior parte delle TV moderne ha questa funzione. Scopri come la chiama il produttore e cercala nelle impostazioni.

Quando il software è installato e il CEC è attivo sulla TV, puoi provare se la TV viene rilevata. Esegui questo comando nel terminale:

echo 'scan' | cec-client -s -d 1

La scansione dura circa 10 secondi e restituisce un elenco di dispositivi. Se vedi la tua TV (di solito come device #0), la connessione funziona. Vedi anche il dispositivo «Pulse Eight»: non farci caso, è un’interfaccia virtuale.

Puoi anche usare la nostra funzione API per accendere o spegnere la TV; si combina con un servizio di webhook programmati, come Crontap.

L’app si blocca all’avvio

Se hai installato tu il sistema operativo e il file .AppImage scaricato non parte, è probabile che manchino delle librerie. Per avere più informazioni, prova prima ad avviare il .AppImage dalla riga di comando:
./PlaySignage*.AppImage
Il terminale mostra l’errore e spesso indica il problema.

bpf failure in syscall 0403 -> Prova ad avviare l’app con un parametro in più:
./PlaySignage*.AppImage --disable-seccomp-filter-sandbox

Perché non posso usare la risoluzione 4K?

Ci sono problemi noti di accelerazione hardware con i driver VideoCore e il supporto dell’HTML5 canvas su cui è costruita l’app. Abbiamo disattivato il driver a favore della stabilità; si può però far girare Raspberry Pi OS con il driver e disattivare l’accelerazione hardware:

• Attiva il driver VideoCore nel file /boot/config.txt togliendo il commento da questa riga: dtoverlay=vc4-fkms-v3d
• Avvia l’app Play Digital Signage con l’accelerazione hardware disattivata: ./PlaySignage*.AppImage --disable-hardware-acceleration

Un sito intranet con certificato SSL autofirmato non si vede?

Per precauzione di sicurezza, l’applicazione non mostra i siti con errori di certificato. Se però devi mostrare un sito senza un certificato SSL valido, puoi avviare l’app con il parametro --ignore-certificate-errors, per esempio:
~/Downloads/PlaySignage.AppImage --ignore-certificate-errors

Come attivo ssh?

Abbiamo disattivato l’accesso SSH per ovvi motivi di sicurezza, dato che l’immagine ha una password predefinita. Se vuoi attivare SSH per la manutenzione da remoto, ecco come:

1. Esegui il comando passwd per cambiare la password: quella predefinita è raspberry, e la conoscono tutti
2. Apri la porta 22 nel firewall: sudo ufw allow ssh
3. Attiva il servizio SSH: sudo systemctl enable ssh
4. Avvia il servizio SSH: sudo systemctl start ssh

Come accedo a OPTIONS se ho disattivato la barra del menu in alto?

Nelle opzioni dell’app puoi nascondere la barra del menu in alto, per esempio su uno schermo touch. Quando è nascosta, usa CTRL + O per le opzioni o CTRL + Q per chiudere l’app.

Posso accendere e spegnere lo schermo?

Sì. Vedi la guida Accendere e spegnere la TV.