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

Project links

Data verified by PyPI on Jul 13, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dmunozv04 from gravatar.com dmunozv04

Credits

Author: dmunozv04

GitHub Statistics

Data verified by PyPI on Jul 13, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU General Public License v3 (GPLv3)

Requires

Python >=3.11

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

isponsorblocktv-2.10.0.tar.gz (50.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

isponsorblocktv-2.10.0-py3-none-any.whl (51.2 kB view details)

Uploaded Python 3

File details

Details for the file isponsorblocktv-2.10.0.tar.gz.

File metadata

  • Download URL: isponsorblocktv-2.10.0.tar.gz
  • Upload date:
  • Size: 50.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for isponsorblocktv-2.10.0.tar.gz
Algorithm Hash digest
SHA256 3f7437336bbfdca1136e21baedf1029f7d572533e74032b8ebb847b2f33856f8
MD5 6f44f1dc5f99e2838a191ef2faa0df57
BLAKE2b-256 3a404254cec42fe47a4e5ebecded067f5d25e11b4ad05a544379e0af57ed156f

See more details on using hashes here.

Provenance

The following attestation bundles were made for isponsorblocktv-2.10.0.tar.gz:

Publisher: release.yml on dmunozv04/iSponsorBlockTV

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file isponsorblocktv-2.10.0-py3-none-any.whl.

File metadata

File hashes

Hashes for isponsorblocktv-2.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 12fb3acc7132e54948b406bd2615ee428e89833a296d967351bcc08f4953822b
MD5 a9a6a627660fc890b7b849be456e1c61
BLAKE2b-256 ac4666453ef5db177b16b56cf6c21b35fd7b02ce21124ac506f16f67a532dc38

See more details on using hashes here.

Provenance

The following attestation bundles were made for isponsorblocktv-2.10.0-py3-none-any.whl:

Publisher: release.yml on dmunozv04/iSponsorBlockTV

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page