Mit einem Raspberry Pi, einem DVB-T2-Stick und TVHeadend wird der Pi zum leistungsfähigen TV-Streaming-Server fürs Heimnetzwerk – alle Geräte im Netzwerk können gleichzeitig Live-TV schauen, aufnehmen und auf den elektronischen Programmführer zugreifen.
Konzept: Raspberry Pi als TV-Server
TVHeadend läuft auf dem Pi und stellt Live-TV-Streams sowie EPG (Programmführer) für alle Clients im Netzwerk bereit. Als Clients funktionieren Kodi, VLC, Smartphones, Smart-TVs und Browser. Der Pi selbst braucht keinen Bildschirm – er läuft als Headless-Server, ihr konfiguriert alles über das Web-Interface.
Wer lieber eine Komplettlösung mit Kodi direkt auf dem Pi möchte (ohne separates Server-Setup), sollte sich Live-TV mit TVHeadend auf LibreELEC anschauen – dort läuft Kodi und TVHeadend auf einem einzigen Pi.
Voraussetzungen
- Raspberry Pi 3, 4 oder 5 mit Raspberry Pi OS Bookworm (Lite reicht)
- USB-DVB-T2-Receiver mit Linux-Treiber – z.B. Sundtek MediaTV Pro III oder August DVB-T210
- DVB-T2-Antenne (Zimmerantenne ausreichend bei guter Empfangslage)
- microSD-Karte oder besser NVMe-SSD für Aufnahmen
- Netzwerkverbindung (LAN empfohlen für stabiles Streaming)
Tipp zu DVB-Sticks: Nicht jeder USB-DVB-Stick wird unter Linux erkannt. Die sicherste Wahl sind Sticks mit dem Chip RTL2832U (sehr gute Treiberunterstützung) oder dem Hauppauge WinTV-dualHD (auch DVB-T2 H.265). Schaut vor dem Kauf in die LinuxTV Geräteliste.
Falls ihr euren Raspberry Pi noch nicht eingerichtet habt, helfen unsere Raspberry Pi Einsteiger Guides beim Start. Da TVHeadend als Headless-Server läuft, reicht SSH vollkommen aus – wie ihr SSH am Raspberry Pi aktiviert erklärt der verlinkte Artikel.
Schritt 1: TVHeadend installieren
System aktualisieren und TVHeadend installieren:
|
1 2 |
sudo apt update && sudo apt upgrade -y sudo apt install tvheadend -y |
Während der Installation werdet ihr nach Benutzername und Passwort für das Webinterface gefragt – notiert diese gut.
TVHeadend beim Start aktivieren und sofort starten:
|
1 2 |
sudo systemctl enable tvheadend sudo systemctl start tvheadend |
Status prüfen:
|
1 |
sudo systemctl status tvheadend |
Schritt 2: DVB-Stick anschließen und prüfen
Steckt euren DVB-T2-Stick an und prüft ob er erkannt wurde:
|
1 2 |
lsusb dmesg | grep -i dvb |
Wenn der Stick erkannt wurde, erscheint er unter /dev/dvb/:
|
1 |
ls /dev/dvb/ |
Schritt 3: Webinterface aufrufen
Browser öffnen und folgende Adresse eingeben (IP-Adresse eures Pi einsetzen):
|
1 |
http://raspberrypi.local:9981 |
Mit den bei der Installation gewählten Zugangsdaten anmelden. Beim ersten Start startet TVHeadend den Einrichtungsassistenten.
Schritt 4: DVB-T2-Adapter einrichten
Im Konfigurationsassistenten oder unter Configuration → DVB Inputs → TV Adapters:
- Euren DVB-Stick auswählen und aktivieren (Haken bei „Enabled“)
- Unter Networks → Add → DVB-T Network: Land Deutschland, Preset Deutschland (DVB-T2)
- Save and then Force Scan – TVHeadend sucht alle verfügbaren Sender
Der Scan dauert je nach Empfang 1–3 Minuten.
Schritt 5: Sender zuordnen (Map Services)
Nach dem Scan unter Configuration → DVB Inputs → Services alle gefundenen Sender markieren und auf „Map all services“ klicken. Die Sender erscheinen danach unter Configuration → Channel / EPG → Channels.
Schritt 6: EPG-Programmführer einrichten
TVHeadend kann EPG-Daten automatisch über OTA (Over-the-Air) empfangen. Unter:
|
1 |
Configuration → Channel / EPG → EPG Grabber Modules |
Aktiviert „Over-the-air EPG“ und speichert. Nach dem nächsten EPG-Lauf (oder manuell über „Trigger OTA EPG grabber now“) stehen Programmdaten zur Verfügung.
Schritt 7: Aufnahmen einrichten
Verzeichnis für Aufnahmen erstellen und TVHeadend-Benutzer Schreibrechte geben:
|
1 2 |
sudo mkdir -p /media/aufnahmen sudo chown hts:video /media/aufnahmen |
In TVHeadend unter Configuration → Recording → Storage den Pfad /media/aufnahmen eintragen.
Tipp: Für regelmäßige Aufnahmen empfiehlt sich eine externe USB-Festplatte oder beim Pi 5 eine NVMe-SSD – SD-Karten verschleißen durch viele Schreibvorgänge schnell.
Live TV in Kodi streamen
In Kodi das Add-on „Tvheadend HTSP Client“ installieren:
- Kodi → Add-ons → Add-on Browser → Nach Add-ons suchen → „TVHeadend“
- Tvheadend HTSP Client installieren und konfigurieren
- IP-Adresse des Pi und Port 9982 eintragen
- Benutzername und Passwort aus der TVHeadend-Installation eingeben
Nach einem Neustart von Kodi erscheinen eure Sender im TV-Bereich. Wer Kodi komplett auf dem Raspberry Pi einrichten möchte, findet dazu eine ausführliche LibreELEC-Anleitung mit TVHeadend auf raspberry.tips.
Alternativ gibt es für Kodi auch viele weitere IPTV-Add-ons für Live-TV über IP-Streams ohne DVB-Hardware.
Live TV per Browser oder VLC
TVHeadend bietet auch einen eingebauten Webplayer. Direkt im Browser unter http://raspberrypi.local:9981 auf einen Sender klicken – der Stream startet sofort.
Für VLC: Datei → Netzwerk öffnen → http://raspberrypi.local:9981/stream/channel/...
Auf Smartphones und Tablets empfiehlt sich die App nPlayer (iOS) oder Kodi (Android/iOS) mit dem TVHeadend-Add-on für den bequemsten Zugriff.
Fehlerbehebung
Stick wird nicht erkannt
|
1 |
dmesg | tail -30 |
Falls Firmware fehlt, z.B. für Realtek-Chips:
|
1 2 |
sudo apt install firmware-misc-nonfree -y sudo reboot |
Schlechter Empfang / wenige Sender
Antenne möglichst hoch und in Richtung des nächsten Sendeturms ausrichten. Aktive Zimmerantennen verbessern den Empfang deutlich. Sendeturm-Standorte findet ihr unter bundesnetzagentur.de.
TVHeadend läuft, aber keine Sender
Prüft ob DVB-T2 in eurer Region aktiv ist. In manchen ländlichen Gebieten gibt es ausschließlich Satellit oder Kabel – dort ist DVB-T2 nicht verfügbar.
Port 9981 nicht erreichbar
Prüft ob TVHeadend wirklich läuft und auf dem richtigen Interface lauscht:
|
1 2 |
sudo systemctl status tvheadend ss -tlnp | grep 9981 |
Passende Artikel
- Live-TV mit TVHeadend auf LibreELEC – Kompletteinrichtung – Kodi + TVHeadend auf einem Pi
- IPTV-Add-ons für Kodi – Live-TV über IP ohne DVB-Hardware
- Raspberry Pi 5 NVMe SSD einrichten – Schneller Speicher für Aufnahmen
- SSH am Raspberry Pi aktivieren – Headless-Setup ohne Monitor
