explaingit

dmunozv04/isponsorblocktv

5,632PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

iSponsorBlockTV is a self-hosted program that automatically skips sponsor segments, intros, and ads on YouTube TV apps across Apple TV, smart TVs, streaming sticks, and game consoles, no remote needed after initial setup.

Mindmap

mindmap
  root((iSponsorBlockTV))
    What it does
      Skip sponsor segments
      Skip ads instantly
      Mute non-skippable ads
    Supported Devices
      Apple TV
      Android TV and Google TV
      Samsung Tizen and LG WebOS
      Roku Fire TV Xbox PlayStation
    Setup
      Run on any computer
      Pair once via code
      Home Assistant add-on
    Tech Stack
      Python
      SponsorBlock community data
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Automatically skip sponsor segments, intros, and filler in YouTube videos on your smart TV without touching the remote.

USE CASE 2

Instantly click the Skip Ad button on your TV's YouTube app the moment a skippable ad appears.

USE CASE 3

Mute non-skippable ads on your TV's YouTube app automatically.

USE CASE 4

Manage iSponsorBlockTV from Home Assistant alongside your other smart home automations.

Tech stack

Python

Getting it running

Difficulty · moderate Time to first run · 30min

Initial pairing requires entering a code from your TV's YouTube settings, after pairing, the host computer only needs internet access, not local network access to the TV.

Licensed under GNU GPLv3, you can use, modify, and share this software freely, but any modified version you distribute must also be open source under the same license.

In plain English

iSponsorBlockTV is a self-hosted program that watches what you are doing on a YouTube TV app and automatically skips the parts of videos that other viewers have labeled as sponsored content, introductions, or filler. It relies on SponsorBlock, a community database where people tag time ranges in YouTube videos so others can skip them. The program also detects when YouTube shows a skippable ad and clicks the "Skip Ad" button the instant it appears, and it can mute non-skippable ads automatically. You install and run the program on any computer that has internet access. That computer does not need to be on the same local network as your TV during normal use, only during the initial setup step where it finds and pairs with the TV. Once paired, it runs in the background and the skipping happens without any action on your part. If your TV is not auto-detected, you can pair it manually by entering a code found in the YouTube TV settings. The program supports a wide range of devices: Apple TV, Samsung TVs running Tizen, LG TVs running WebOS, Android TV, Chromecast, Google TV, Roku, Fire TV, the Chromecast with Google TV, Nintendo Switch, Xbox One and Series consoles, and PlayStation 4 and 5. That covers most modern smart TV and streaming hardware in common use. Setup instructions are on the project wiki. There is a graphical configuration tool built into the program, so you do not need to edit config files by hand. A Home Assistant add-on is also available for people who already run a Home Assistant home automation setup, making it easier to manage iSponsorBlockTV alongside other smart home services. The project is open source and accepts contributions. It is written in Python and distributed under the GNU GPLv3 license.

Copy-paste prompts

Prompt 1
I want to run iSponsorBlockTV on a Raspberry Pi to skip YouTube ads on my Apple TV. Walk me through setup from cloning the repo to pairing with my TV.
Prompt 2
How do I pair iSponsorBlockTV with a Samsung Tizen TV when auto-detection doesn't find it on the network?
Prompt 3
Show me how to add iSponsorBlockTV as a Home Assistant add-on and configure it to skip sponsor segments on my Chromecast.
Prompt 4
I want iSponsorBlockTV to skip only sponsor segments and intros but not outros. How do I set those preferences in the graphical config tool?
Open on GitHub → Explain another repo

← dmunozv04 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.