iSponsorBlockTV

iSponsorBlockTV

Docker app from grtgbln's Repository

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…

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
    
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 for 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.

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

Categories

Download Statistics

132,466
Total Downloads
37,099
This Month
13,079
Avg / Month

Total Downloads Over Time

Loading chart...

Links

Details

Repository
ghcr.io/dmunozv04/isponsorblocktv:latest
Last Updated2026-10-14
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