iSponsorBlockTV: YouTube Werbung am TV automatisch skippen

Estimated reading time: 13 Minuten

Kennst du das? Du sitzt gemütlich auf der Couch, hast dir gerade ein spannendes YouTube-Video auf deinem Smart-TV angemacht, das Essen steht bereit, und kaum hast du den ersten Bissen genommen, unterbricht der YouTuber den Content. „Bevor wir anfangen, möchte ich euch kurz meinen Partner XY vorstellen…“ Oder noch schlimmer: Mitten im spannendsten Moment kommt ein dreiminütiger Monolog über VPNs, Rasierklingen oder Online-Rollenspiele. Mindestens genauso nervig ist die Werbung am Anfang oder eben auch mittendrin, die dann drei Mal so laut ist wie das Video.

Am PC hast du dafür längst eine Lösung: SponsorBlock und uBlockOrigin bzw. AdBlock. Die geniale Browser-Erweiterung, die dank einer riesigen Community solche Segmente markiert und automatisch überspringt. Aber am Fernseher? Auf dem Apple TV? Auf dem Chromecast? Da warst du bisher oft machtlos und musstest hektisch zur Fernbedienung greifen, um vorzuspulen.

Doch damit ist jetzt Schluss. Ich zeige dir heute ein Tool, das dein YouTube-Erlebnis im Wohnzimmer revolutionieren wird: iSponsorBlockTV.

Für eine detaillierte Anleitung und Erklärung aller Konfigurationsmöglichkeiten empfehle ich das unten verlinkte YouTube-Video. In diesem Video wird ausführlich auf jede einzelne Einstellung eingegangen, sodass du eine umfassende Anleitung zur genauen Einrichtung erhältst. Eventuellen Code aus dem Video findest du in diesem Beitrag, so dass du ihn direkt nutzen kannst, ohne abtippen zu müssen.

Dieser Blogbeitrag inklusive Video ist Teil einer Serie, in der wir unseren eigenen Homeserver erstellen und einrichten. Wir fangen bei den Basics an, wie einer Ubuntu-VM-Installation mit Docker, und machen dann weiter mit der Konfiguration einer eigenen Domain, Sicherheitsvorkehrungen und vor allem mit jeder Menge coolen und nützlichen selbstgehosteten Diensten. Egal ob Medienserver wie Plex oder Jellyfin oder Dokumentenmanagement wie Paperless-NGX. Wir bauen gemeinsam das Setup auf, das ihr sehen möchtet. Selbst Themen wie Single Sign-On (SSO) gehen wir gemeinsam an.

Was ist iSponsorBlockTV eigentlich?

Bevor wir Code in das Terminal tippen, müssen wir verstehen, was hier eigentlich passiert. Denn iSponsorBlockTV (kurz iSBTV) ist keine App, die du auf deinem Fernseher installierst. Es ist auch kein klassischer AdBlocker, der Netzwerkanfragen blockiert (wie Pi-hole).

Das Funktionsprinzip: Der unsichtbare Fernbedienungs-Roboter

Stell dir iSponsorBlockTV wie einen unsichtbaren Assistenten vor, der neben dir auf der Couch sitzt und ebenfalls auf deinen Fernseher starrt. Dieser Assistent hat Zugriff auf die Datenbank von SponsorBlock. Er weiß also genau: „Aha, bei Minute 2:30 fängt die Werbung für ‚Raid Shadow Legends‘ an und bei 3:45 ist sie vorbei.“

Sobald dein Video diesen Zeitstempel erreicht, drückt der unsichtbare Assistent blitzschnell auf „Vorspulen“, sodass du nahtlos bei Minute 3:46 landest.

Technisch gesehen läuft iSponsorBlockTV auf einem Server in deinem Netzwerk (zum Beispiel einem Raspberry Pi, einem NAS oder deinem PC). Es verbindet sich über die API mit deinem Streaming-Gerät (Apple TV, Chromecast, Android TV) und fragt ständig: „Was guckst du gerade? Wo bist du im Video?“. Wenn es einen Treffer in der Datenbank gibt, sendet das Skript den Befehl zum Springen an den TV.

Der riesige Vorteil: Du musst deinen Fernseher nicht hacken, nicht rooten und keine dubiosen APK-Dateien installieren. Es funktioniert mit der offiziellen YouTube-App!

Die Features: Mehr als nur „Werbung weg“

Du denkst vielleicht: „Okay, es überspringt Werbung.“ Aber iSBTV ist deutlich mächtiger. Dank der granularen Datenbank von SponsorBlock kannst du genau entscheiden, was du sehen willst und was nicht. Hier sind die Kategorien, die du steuern kannst:

1. Sponsoren (Sponsor)

Das ist der Klassiker. Bezahlte Produktplatzierungen, die direkt im Video integriert sind. Diese Segmente haben mit dem eigentlichen Inhalt nichts zu tun und werden meistens von den Creatorn selbst eingesprochen.

• Deine Aktion: Automatisch überspringen.

2. Eigenwerbung (Self-Promotion)

„Kauft mein Merch!“, „Checkt meinen anderen Kanal aus!“, „Ich habe ein Buch geschrieben!“. Auch wenn wir unsere Lieblings-YouTuber unterstützen wollen – manchmal nervt es einfach.

• Deine Aktion: Kannst du überspringen oder drin lassen, wenn du Fan bist.

3. Interaktionsaufforderungen (Interaction Reminder)

„Leute, vergesst nicht zu liken, zu abonnieren und die Glocke zu drücken!“ – Das hören wir in fast jedem Video. iSponsorBlockTV kann diese nervigen 10-Sekunden-Phrasen einfach rausschneiden.

• Deine Aktion: Weg damit!

4. Intro & Outro

Manche Kanäle haben extrem lange Intros (Animationen, Musik) oder Outros mit Abspann. Wenn du eine Playlist durchsuchtest (Binge-Watching), stört das den Fluss massiv.

• Deine Aktion: Automatisch skippen für nahtlosen Genuss.

5. Musik: Nicht-musikalischer Teil (Music: Off-topic)

Ein Segen für Musikvideos! Kennst du das? Du willst ein Musikvideo sehen, aber das Video hat ein 2-minütiges schauspielerisches Intro, bevor der Song überhaupt anfängt. iSponsorBlockTV schneidet das weg und startet direkt beim Beat.

6. Vorschau & Rückblick (Preview/Recap)

„Was bisher geschah…“ oder „Im nächsten Video seht ihr…“. Wenn du die Videos hintereinander schaust, ist das redundant. Das Tool erkennt und entfernt es.

Voraussetzungen: Was brauchst du?

Damit das Projekt gelingt, brauchst du ein wenig Hardware und Software. Aber keine Sorge, die Hürden sind niedrig.

Hardware

1. Ein Streaming-Gerät:
   • Apple TV (tvOS)
   • Google Chromecast
   • Android TV / Google TV (Nvidia Shield, Sony TVs, Philips TVs, etc.)
   • Amazon Fire TV (mit Einschränkungen, da Android-basiert)
   • Smart TVs mit integrierter YouTube-App (sofern sie das Cast-Protokoll unterstützen)
2. Einen „Server“: Das Skript muss immer laufen, wenn du fernsehen willst. Dein Laptop ist dafür ungeeignet, wenn du ihn zuklappst. Ideal sind:
   • Raspberry Pi (Model 3, 4 oder 5 – sogar ein Zero 2 W reicht locker).
   • NAS (Synology, QNAP) mit Docker-Unterstützung.
   • Mini-PC / Home Server (Intel NUC, alter Office-PC mit Linux).
   • Server eines Freunds: du musst nicht einmal einen eigenen Server haben, das kann auch bei einem Freund oder Cloudanbieter laufen. Das Tool braucht keinen Zugriff auf das lokale Netzwerk.

Software

Wir konzentrieren uns hier voll auf Docker. Warum? Weil es die sauberste Methode ist. Du müllst dir dein System nicht mit Python-Abhängigkeiten voll, und Updates sind ein Kinderspiel.

• Du solltest Grundkenntnisse im Umgang mit dem Terminal haben.
• Docker und Docker Compose müssen auf deinem Server installiert sein.

Installation via Docker: Der Schritt-für-Schritt-Guide

Jetzt geht es ans Eingemachte. Wir installieren iSponsorBlockTV auf einem Linux-basierten System (z.B. Raspberry Pi OS oder Ubuntu).

Wir nutzen Docker Compose, weil wir damit die Konfiguration in einer Datei speichern können. Das macht Updates und Neustarts viel einfacher als lange docker run Befehle.

Erstelle die Datei:

nano docker-compose-isponsorblocktv.yml

Kopiere nun folgenden Inhalt hinein. Ich habe die Konfiguration bereits optimiert:

services:
  isponsorblocktv:
    image: ghcr.io/dmunozv04/isponsorblocktv
    container_name: isponsorblocktv
    restart: unless-stopped
    # network_mode: host # to auto-discover devices
    networks:
      - sascha
    environment:
      - TZ=Europe/Berlin
    volumes:
      - /mnt/cache/appdata/network/isponsorblocktv:/app/data:rw

networks:
  sascha:
    external: true

Wichtige Erklärungen zu dieser Konfiguration:

• image: ghcr.io/dmunozv04/isponsorblocktv:latest: Wir ziehen immer die aktuellste Version direkt vom Entwickler.
• restart: unless-stopped: Wenn der Strom ausfällt oder der Pi neu startet, fährt auch dieser Dienst automatisch wieder hoch.
• network_mode: host: Das ist der wichtigste Punkt! Damit iSponsorBlockTV deine Fernseher im Netzwerk finden kann (Discovery), muss es vollen Zugriff auf das Netzwerk haben. Ohne diesen Modus scheitert oft die Erkennung der Geräte.
• volumes: /mnt/cache/appdata/network/isponsorblocktv:/app/data:rw: Wir speichern die Konfiguration (welche TVs gekoppelt sind) außerhalb des Containers. So gehen deine Einstellungen bei einem Update nicht verloren.

Speichere die Datei mit STRG + O, Enter und beende den Editor mit STRG + X.

Der erste Start & das Setup

Jetzt starten wir den Container. Aber Achtung: Beim ersten Mal müssen wir interaktiv eingreifen, um den Setup-Wizard zu durchlaufen.

docker run --rm -it --net=host -v /mnt/cache/appdata/network/isponsorblocktv:/app/data ghcr.io/dmunozv04/isponsorblocktv --setup-cli

oder auch mit grafischer Oberfläche:

docker run --rm -it --net=host -v /mnt/cache/appdata/network/isponsorblocktv:/app/data ghcr.io/dmunozv04/isponsorblocktv --setup

Du wirst durch einen Setup-Guide geleitet und musst dich vorher nicht einlesen. Die Anleitung ist selbstverständlich.

Der Pairing-Prozess (Die Magie beginnt)

Sobald du den Setup-Befehl ausführst, begrüßt dich der Wizard im Terminal.

1. YouTube API: Das Tool fragt dich, ob du die YouTube API nutzen willst. Das ist optional, aber empfohlen, um bessere Metadaten zu bekommen. Für den Anfang kannst du das aber oft überspringen oder den Standard nutzen.
2. Geräte finden: Das Tool scannt jetzt dein Netzwerk. Stelle sicher, dass dein Smart TV / Apple TV / Shield eingeschaltet ist und die YouTube-App offen ist (oder zumindest das Gerät im Netzwerk aktiv ist).
3. Namensgebung: Du wirst gefragt, wie du das gefundene Gerät nennen willst (z.B. „Wohnzimmer TV“).

Jetzt kommt der entscheidende Moment: Das Tool fordert dich auf, dich auf deinem Fernseher anzumelden. Es funktioniert ähnlich wie wenn du dein Handy mit dem TV koppelst.

1. Öffne die YouTube-App auf deinem TV.
2. Gehe zu Einstellungen -> Mit TV-Code verknüpfen.
3. Dort wird ein blauer Zahlencode angezeigt (z.B. 123 456 789).
4. Diesen Code gibst du jetzt in deinem Terminal ein.

Warum machen wir das? iSponsorBlockTV gibt sich gegenüber deinem Fernseher als „Fernbedienung“ aus (ähnlich wie die YouTube-App auf deinem Handy). Sobald der Code akzeptiert ist, hat dein Server die Erlaubnis, den Status abzufragen („Welches Video läuft?“) und Befehle zu senden („Springe zu Sekunde 400“).

Diesen Prozess wiederholst du für alle Fernseher im Haus (Schlafzimmer, Küche, etc.).

Neustart und Genießen

Wenn du mit dem Setup durch bist, wird eine config.json in deinem ./data Ordner erstellt.

Öffne dein Terminal und du kannst die Services dann ganz einfach mit folgendem Befehl starten (der Name muss natürlich angepasst werden):

docker compose -f "docker-compose-isponsorblocktv.yml" up -d

Prüfe die Logs:

docker compose logs -f

Wenn du jetzt am TV ein Video startest, solltest du im Log sehen: [Wohnzimmer TV] Now playing: Linus Tech Tips - Why Windows sucks... [Wohnzimmer TV] Found 3 segments to skip. [Wohnzimmer TV] Skipped Sponsor from 0:00 to 1:30.

Es funktioniert! 🎉

Fein-Tuning: Die Konfiguration perfektionieren

Die Standard-Einstellungen sind gut, aber wir wollen „perfekt“. Die Datei config.json in deinem data-Ordner ist der Schlüssel dazu. Du kannst sie mit nano data/config.json bearbeiten.

Hier erkläre ich dir die wichtigsten Parameter, die du anpassen kannst, um das Verhalten genau auf deine Bedürfnisse zuzuschneiden.

Skip vs. Mute vs. Nichts tun

Für jede Kategorie (Sponsor, Intro, Outro etc.) kannst du festlegen, was passieren soll. Die Modi sind:

• skip: Hartes Überspringen.
• mute: Der Ton wird ausgeschaltet, das Video läuft weiter (gut für Segmente, die man sehen will, aber nicht hören, oder wenn das Skippen Fehler verursacht).
• nothing: Das Segment wird ignoriert.

Beispiel-Konfiguration in der JSON:

"categories": {
    "sponsor": "skip",
    "intro": "skip",
    "outro": "skip",
    "interaction": "mute",
    "selfpromo": "nothing",
    "music_offtopic": "skip"
}

In diesem Beispiel: Sponsoren werden übersprungen. Das „Like & Subscribe“-Gerede wird nur stummgeschaltet (vielleicht ist das Visuelle ja lustig?), und Eigenwerbung darf der Creator behalten.

Die „Unskip“ Funktion

Manchmal überspringt SponsorBlock zu viel oder ein Segment ist falsch markiert. Was dann? Du kannst in der Config einstellen, dass iSBTV auf bestimmte Befehle reagiert. Wenn du zum Beispiel auf der Fernbedienung kurz zurückspulst, merkt das Tool: „Oh, der User will das doch sehen“ und hört auf, dieses Segment sofort wieder zu überspringen.

Whitelisting: Deine Lieblings-Creator unterstützen

Das ist ein moralisch wichtiger Punkt. Wenn du bestimmte Kanäle hast, deren Werbung du gerne sehen möchtest, um sie zu unterstützen (oder weil deren Werbung tatsächlich unterhaltsam ist – Grüße gehen raus an Internet Historian), kannst du diese Whitelisten.

Füge die Kanal-ID (nicht den Namen, sondern die ID, die du in der URL des Kanals findest) in die config.json unter whitelist ein.

Troubleshooting: Wenn es mal hakt

Technik ist nie fehlerfrei. Hier sind die häufigsten Probleme bei iSponsorBlockTV und wie du sie löst.

1. Mein Fernseher wird nicht gefunden

• Ursache: Oft liegt es am Netzwerk.
• Lösung: Hast du network_mode: host in der Docker Compose Datei genutzt? Sind der Server und der TV im selben Subnetz? Manche Router (FritzBox Gastnetzwerk) isolieren Geräte. Prüfe, ob du den TV vom Server aus anpingen kannst.

2. Die Lautstärke schwankt

• Ursache: Wenn du Segmente auf „mute“ gestellt hast, muss das Tool die Lautstärke ändern. Manchmal stellt es sie nicht korrekt auf den Ursprungswert zurück.
• Lösung: Stelle die Kategorie lieber auf „skip“ oder deaktiviere die Mute-Funktion in der Config, wenn es nervt.

3. Es wird nicht geskippt, obwohl ein Sponsor läuft

• Ursache: Manchmal ändert YouTube intern Protokolle oder die Video-ID wird nicht korrekt übermittelt.
• Lösung: Starte das Video neu. Prüfe im Log (docker compose logs), ob das Video überhaupt erkannt wurde. Manchmal hilft ein Neustart des Containers.

4. Verbindung verfällt

• Ursache: Die Pairing-Codes sind nicht ewig gültig, aber iSBTV erneuert die Tokens normalerweise automatisch.
• Lösung: Wenn nichts mehr geht: Lösche die config.json (oder den Teil mit den Tokens) und führe das Setup (--setup) erneut durch.

Performance & Ressourcenverbrauch

Du fragst dich vielleicht: „Zieht das meinen Raspberry Pi in die Knie?“ Die Antwort ist ein klares: Nein.

iSponsorBlockTV ist extrem leichtgewichtig. Es ist im Grunde nur ein Text-Verarbeiter, der ab und zu kleine Netzwerkanfragen sendet.

• CPU: Vernachlässigbar (< 1%).
• RAM: Wenige Megabyte (meist unter 50MB).
• Netzwerk: Nur wenige Kilobyte pro Minute für Statusabfragen.

Du kannst diesen Container problemlos neben Home Assistant, Pi-hole und Plex laufen lassen, ohne Einbußen zu bemerken.

Vergleich: SmartTube(Next) vs. iSponsorBlockTV

Viele Android-TV-Nutzer schwören auf SmartTube (ehemals SmartTubeNext). Warum sollte man also iSponsorBlockTV nutzen?

Hier ist der Vergleich:

Feature	SmartTube	iSponsorBlockTV
Plattform	Nur Android TV / Fire TV	Alle (Apple TV, WebOS, Tizen, Chromecast, Android)
Installation	Sideloading (APK)	Docker auf externem Server
App-Feeling	Eigene App (andere Oberfläche als YouTube)	Originale YouTube App
Sicherheit	Drittanbieter-App (Login nötig)	Nutzt Cast-Protokoll (Sicherer)
Werbung	Blockt Banner & Sponsoren	Blockt nur Sponsoren (Banner bleiben evtl.)

Umsetzung im YouTube-Video

Fazit: Ein Muss für jeden Heimkino-Enthusiasten

iSponsorBlockTV ist eines dieser Tools, von denen man nicht wusste, dass man sie braucht – bis man sie einmal benutzt hat. Danach kann man nicht mehr zurück. Der Komfortgewinn ist massiv. Es ist faszinierend zu sehen, wie der Fernseher wie von Geisterhand genau die nervigen Teile eines Videos überspringt.

Die Installation via Docker mag auf den ersten Blick abschreckend für Laien wirken, ist aber dank der docker-compose Methode in wenigen Minuten erledigt. Einmal eingerichtet, läuft das System monatelang wartungsfrei im Hintergrund („Set and Forget“).

Besonders für Besitzer von geschlossenen Systemen wie dem Apple TV ist dies der heilige Gral. Endlich gleichziehen mit den PC-Nutzern!

Also, worauf wartest du? Fahr den Raspberry Pi hoch und erobere dir deine Lebenszeit zurück!

Nützliche Links auf einen Blick

• GitHub Repository: dmunozv04/iSponsorBlockTV
• SponsorBlock Datenbank: sponsor.ajay.app
• Docker-Dokumentation: docs.docker.com

Interesse, aber Zeit oder Kenntnisse fehlen?

Kein Problem. Kontaktieren Sie mich und wir besprechen Ihre Anforderungen. Egal, ob geschäftlich oder privat.