iSponsorBlockTV

iSponsorBlockTV

Docker app from grtgbln's Repository

Overview

iSponsorBlockTV is a self-hosted application that connects to your YouTube TV app (see compatibility below) and automatically skips segments (like Sponsors or intros) in YouTube videos using the SponsorBlock API. It can also auto mute and press the "Skip Ad" button the moment it becomes available on YouTube ads.

iSponsorBlockTV

ghcr.io Pulls Docker Pulls GitHub Release GitHub Repo stars

iSponsorBlockTV is a self-hosted application that connects to your YouTube TV app (see compatibility below) and automatically skips segments (like Sponsors or intros) in YouTube videos using the SponsorBlock API. It can also auto mute and press the "Skip Ad" button the moment it becomes available on YouTube ads.

[!WARNING] YouTube appers to have changed the screen ID code format and is in the process of revoking all existing codes. This means that you'll have to pair your device again. You can find information on how to do that in the wiki.

Installation

Check the wiki

Compatibility

Legend: ✅ = Working, ❌ = Not working, ❔ = Not tested

Open an issue/pull request if you have tested a device that isn't listed here.

Device Status
Apple TV ✅*
Samsung TV (Tizen)
LG TV (WebOS)
Android TV
Chromecast
Google TV
Roku
Fire TV
CCwGTV
Nintendo Switch
Xbox One/Series
Playstation 4/5

*Ad muting won't work when using AirPlay to send the audio to another speaker.

** Shorts aren't fully supported due to limitations on YouTube's side. A single short can be seen by either selecting the "Disconnect" option in the warning shown or by long pressing the thumbnail to open the menu and clicking play from there

Usage

Run iSponsorBlockTV on a computer that has network access. It doesn't need to be on the same network as the device, only access to youtube.com is required.

Auto discovery will require the computer to be on the same network as the device during setup. The device can also be manually added to iSponsorBlockTV with a YouTube TV code. This code can be found in the settings page of your YouTube TV application.

Libraries used

Projects using this project

Contributing

  1. Fork it (https://github.com/dmunozv04/iSponsorBlockTV/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

Contributors

Made with contrib.rocks.

License

GNU GPLv3

Install iSponsorBlockTV on Unraid in a few clicks.

Find iSponsorBlockTV in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for iSponsorBlockTV Review the template variables and paths Click Install

Requirements


        Run in host network mode to auto-discover YouTube TV devices on your network.
        
        Requires running initially with **--setup-cli** added to Extra Parameters and opening a Console session to complete initial setup. See setup instructions: https://github.com/dmunozv04/iSponsorBlockTV/wiki/Installation#option-2-using-the-text-based-cli-configurator-tool
    

Download Statistics

67,416
Total Downloads
4,852
This Month
5,701
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
ghcr.io/dmunozv04/isponsorblocktv:latest
Last Updated2026-06-23
First Seen2025-10-31

Runtime arguments

Web UI
http://[IP]:[PORT:1166]/
Network
host
Privileged
false

Template configuration

App DataPath

Path to the app data

Target
/app/data
Default
/mnt/user/appdata/isponsorblocktv/data
Value
/mnt/user/appdata/isponsorblocktv/data