iSponsorBlockTV README

The project's README from github.com/dmunozv04/iSponsorBlockTV. As one markdown file: README.md.

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

iSponsorBlockTV (dmunozv04/iSponsorBlockTV)

sponsorblock
Searching Database…

6.5K ·GitHub
ISponsorBlockTV
What is this?iSponsorBlockTV is a self-hosted app that connects to YouTube apps running on TVs and streaming devices, then automatically skips sponsor segments and similar annotated parts using the SponsorBlock API, and can mute or auto-press 'Skip Ad' on YouTube ads.
Does this install on my TV, or does it run somewhere else?It runs as a background app on a separate computer with network access to youtube.com, and it remotely controls the YouTube app on your TV or streaming device rather than being installed on the device itself.
How do I get it running and connect it to my TV?Full installation steps are in the project wiki; once running, it can auto-discover YouTube TV devices on the same network, or you can manually add a device using the pairing code shown on the YouTube TV app's settings page.
Does the host computer need to be on the same network as my TV?Not for normal use, it only needs access to youtube.com. Being on the same network is only required during initial setup if you want to use auto discovery to find devices.
Which TV platforms and devices does it support?It's confirmed working on Apple TV, Samsung TV (Tizen), LG TV (WebOS), Android TV, Chromecast, Google TV, Roku, Fire TV, CCwGTV, Nintendo Switch, Xbox One/Series, and PlayStation 4/5.
Does it integrate with Home Assistant?Yes, there's a separate Home Assistant Addon that packages iSponsorBlockTV for easy installation inside a Home Assistant setup.
What does the graphical Textual-based configurator do?It gives you a terminal-based graphical interface, built with the Textual library, to configure and pair your YouTube TV devices instead of editing config files by hand.
What happens if I try to watch a YouTube Short?Shorts aren't fully supported, but you can still watch a single Short by choosing 'Disconnect' in the warning that appears, or by long-pressing the thumbnail and selecting play from the menu.
What are similar projects?Ghost-Downloader-3, XHS-Downloader, Levyra-deepsound, YoutubeDownloader, onthespot, Card-master-browser-extension-public, PiliPlus, SimpMusic
Which topics is it in?sponsorblock, asyncio, ad-blocker, home-assistant, self-hosting, youtube, async, tui, streaming, video, utility, gplv3
Creator
dmunozv04
Size
0.7 MB
Stars
6.5K
Updated
CommitAug 21Releasev2.11.0Aug 21
Age
4y
Commits · 90 Days