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.
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
1 maintainer
Metadata
1 maintainer
Release files for iSponsorBlockTV 2.11.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| isponsorblocktv-2.11.0.tar.gz | 51.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| isponsorblocktv-2.11.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 102.6 kB
Release files / isponsorblocktv-2.11.0.tar.gz
| Download URL | isponsorblocktv-2.11.0.tar.gz |
|---|---|
| Size | 51.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
48b7004b91682fc24f4c77e619a0102bd64518006e45f7766157e409c3bb4df9
|
|
BLAKE2b-256 checksum How to use checksums |
0d2a5355d641aaf481b00da635aa128ce5fc5f6937af96e49ad4996d9849880f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 21, 2026.
Transparency logRelease files / isponsorblocktv-2.11.0-py3-none-any.whl
| Download URL | isponsorblocktv-2.11.0-py3-none-any.whl |
|---|---|
| Size | 51.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
967b248ac2cff3639fd61409e67c4770c3c81e934f5fddbe72acfda1b7c1668e
|
|
BLAKE2b-256 checksum How to use checksums |
b4516b6c525e76c04060dc137193a324879f5a78dc9c8e91a2d2a8b73eacc7cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 21, 2026.
Transparency log
