dmunozv04/iSponsorBlockTV
Productivity & UtilitiesSelf-hosted client that connects to YouTube TV apps and auto-skips SponsorBlock segments and skips or mutes ads.
What it does
iSponsorBlockTV is a self-hosted Python application that pairs with the YouTube app on TVs and consoles and uses the SponsorBlock API to skip community-tagged segments such as sponsors, intros and outros. It can also mute and press "Skip Ad" automatically when a YouTube ad becomes skippable. The pairing is handled through pyytlounge, the same Lounge protocol used by YouTube's TV code flow, so it works on Apple TV, Samsung Tizen, LG WebOS, Android TV, Chromecast, Google TV, Roku, Fire TV, Nintendo Switch and Xbox/PlayStation consoles; see the compatibility table.
Quick start
- Run iSponsorBlockTV on a machine with access to youtube.com. It does not need to share a network with the TV unless you want auto-discovery during setup.
- Install it following the installation wiki; there is also a Docker image and GHCR image.
- On first launch, use the Textual-based configurator to discover devices on the LAN or add one manually with the YouTube TV code shown on the TV app's settings page (usage notes).
- Connect the device and start playback; matching SponsorBlock segments are skipped automatically. The result is a normal YouTube TV session without the tagged interruption.
Constraints
- The helper must be able to reach youtube.com, and auto-discovery requires being on the same LAN as the device at setup time.
- Ad muting does not work when audio is sent to another speaker via AirPlay, and Shorts are not fully supported due to YouTube-side limitations (compatibility notes).
- The project is licensed under GPL-3.0 (license).
- Segment data comes from SponsorBlock's community database, so skip quality depends on what viewers have submitted.
HotRepo's take
The repository appeared on GitHub's Python daily list on 2026-11-11 at 10th place with 73 stars gained, and two Hacker News threads from October 2023 and November 2026 drew 115 and 61 comments respectively. Commenters describe low setup effort and reliable skipping on Apple TV, and one notes that you can choose which segment types to skip (discussion). The same thread also carries a reminder that this is not a YouTube ad blocker; it skips in-video sponsorships tagged by the community, not the platform's own ads (comment). That distinction is the main thing to weigh before installing it.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
Hacker News
You might also like
- reisxd/TizenTubeAdds ad blocking, SponsorBlock and title de-clickbaiting to YouTube viewing on Samsung Tizen TVs.
- aleixrodriala/newtubeAn unofficial Android phone client for YouTube, built on SmartTube's engine, with background play, offline saving and SponsorBlock.
- TeamPiped/PipedA privacy-friendly YouTube frontend with its own API and federation, for viewers and self-hosters.