[Guida – RPi] TVHEADEND: guardare la tv in tutta casa avendo una sola presa per l’antenna

24/09/2018 Francesco Russo 0 commenti
Raspberry Pi
Articolo del settembre 2018, aggiornato il 18 ottobre 2026.
Interfaccia web di TVHeadend

Oggi vi voglio mostrare come guardare la TV ovunque in casa avendo una sola presa per l’antenna. Usiamo il nostro solito Raspberry Pi, una chiavetta USB per il digitale terrestre compatibile con Linux e TVHeadend, che riceve i canali dalla chiavetta e li trasmette in rete a TV, PC, smartphone e Kodi.

Guida aggiornata a ottobre 2026: il vecchio repository (bintray) non esiste più, i comandi qui sotto usano quello ufficiale attuale.

Cosa serve

  • Un Raspberry Pi 3, 4 o 5 con Raspberry Pi OS Bookworm (con la nuova versione Trixie usate il metodo Docker più sotto)
  • Una chiavetta DVB-T/DVB-T2 compatibile Linux (io uso la Sky Digital Key, che non uso per Sky)
  • Il cavo dell’antenna collegato alla chiavetta

1. Attivare la Sky Digital Key

Se usate un’altra chiavetta potete saltare questo passaggio. La Sky Digital Key ha bisogno di un firmware che non è incluso nel sistema: scarichiamolo già con il nome giusto e copiamolo nella cartella dei firmware:

wget -O dvb-usb-af9035-02.fw "http://palosaari.fi/linux/v4l-dvb/firmware/af9035/dvb-usb-af9035-02.fw_14ae2b81bac90ff5c6b490c225265267_12.13.15.0_6.20.15.0"
sudo cp dvb-usb-af9035-02.fw /lib/firmware/
sudo reboot

Al riavvio sulla chiavetta dovrebbe accendersi la luce blu. Per controllare che il sistema la veda date ls /dev/dvb: deve comparire adapter0.

2. Installare TVHeadend

Aggiungiamo il repository ufficiale di TVHeadend e installiamolo:

sudo apt update && sudo apt install -y curl
curl -1sLf 'https://dl.cloudsmith.io/public/tvheadend/tvheadend/setup.deb.sh' | sudo -E distro=debian codename=bookworm bash
sudo apt install -y tvheadend

Durante l’installazione vi chiederà nome utente e password per l’amministratore di TVHeadend: segnateveli perché servono per entrare nella pagina web. La parte distro=debian codename=bookworm serve perché Raspberry Pi OS a 32 bit si presenta come “raspbian” e quel ramo del repository è vuoto.

In alternativa: con Docker (anche su Raspberry Pi OS Trixie)

Se avete già Docker sul Raspberry, oppure avete la versione Trixie per cui il repository non ha ancora i pacchetti, potete usare l’immagine di LinuxServer:

docker run -d --name=tvheadend --network=host \
  -e PUID=1000 -e PGID=1000 -e TZ=Europe/Rome \
  -v /home/pi/tvheadend/config:/config \
  -v /home/pi/tvheadend/recordings:/recordings \
  --device /dev/dvb:/dev/dvb \
  --restart unless-stopped lscr.io/linuxserver/tvheadend:latest

3. Configurare chiavetta e canali

Andate nella pagina di TVHeadend all’indirizzo http://IP-RASPBERRY:9981: parte la configurazione guidata che vi fa scegliere la chiavetta, la rete (per l’Italia “DVB-T” con le frequenze “it-All”) e cerca i canali. Ovviamente la chiavetta deve essere collegata all’antenna.

4. Guardare la TV

  • Kodi: installate il client “Tvheadend HTSP”, come spiego nella guida per Kodi con TVHeadend
  • Plex: potete usare TVHeadend come sorgente per la TV live, ecco la guida per guardare la TV live con Plex
  • VLC o qualsiasi player IPTV: aprite la playlist di tutti i canali all’indirizzo http://UTENTE:PASSWORD@IP-RASPBERRY:9981/playlist/channels.m3u

Per vedere contemporaneamente canali di mux diversi servono più tuner (cioè più chiavette), ma con un solo tuner potete vedere tutti i canali dello stesso mux, anche contemporaneamente su dispositivi diversi.

GODETEVI LA TV DOVE VOLETE IN CASA!

Se volete donare per avere più progetti: buymeacoffee.com/rssfra97