whatisgithub

What is isponsorblocktv?

dmunozv04/isponsorblocktv — explained in plain English

Analysis updated 2026-06-26

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

In one sentence

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

What do people build with it?

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.

What is it built with?

Python

How does it compare?

dmunozv04/isponsorblocktvidealo/imagededupoomol-lab/pdf-craft
Stars5,6325,6305,630
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity3/52/53/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is isponsorblocktv?

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.

What language is isponsorblocktv written in?

Mainly Python. The stack also includes Python.

What license does isponsorblocktv use?

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.

How hard is isponsorblocktv to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is isponsorblocktv for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.