Technical Documentation: dmunozv04/iSponsorBlockTV
ℹ️ Provenance: Multi-Tier Ingestion · CodeWiki Reference
Overview (`README.md`)
iSponsorBlockTV
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
- pyytlounge Used to interact with the
device - asyncio and aiohttp
- async-cache
- Textual Used for the amazing new
graphical configurator - ssdp Used for auto discovery
Projects using this project
Contributing
- Fork it (https://github.com/dmunozv04/iSponsorBlockTV/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Contributors
Made with contrib.rocks.
License
--- METRICS ---
- Files Extracted: 1
- Estimated Token Budget: ~831 tokens
- Canonical Reference: https://codewiki.google/github.com/dmunozv04/iSponsorBlockTV