macOS
Homebrewverified · 100%
brew install isponsorblocktvlocal Homebrew formula metadata
brew / rank 11193
Install isponsorblocktv with Homebrew, Nix
SponsorBlock client for all YouTube TV clients. Version 2.10.0 via Homebrew; verified 2026-07-14. Also installable with nix: nix profile install nixpkgs#isponsorblocktv.
install
Additional install commands
Linux
Nixverified · 92%
nix profile install nixpkgs#isponsorblocktvnixpkgs package indexes · pkgs/by-name/is/isponsorblocktv/package.nix · source: api.github.com
overview
Package summary
SponsorBlock client for all YouTube TV clients
Project links
Commands and aliases
- iSponsorBlockTV
history
Project history and usage
iSponsorBlockTV is a self-hosted companion for YouTube TV clients that applies SponsorBlock segment data outside the browser extension environment. Its niche is living beside television and casting clients where the standard SponsorBlock browser-extension model does not apply.
Project history
The project was published by dmunozv04 on GitHub and describes itself as a self-hosted application that connects to a YouTube TV app, skips SponsorBlock segments, can mute ads, and can press the YouTube ad skip button when it appears. Its first GitHub release tag, v0.1, was published on 2022-04-11.
Version 2.0.0 was published on 2023-10-13 and marked a major project transition. Later 2.x releases focused on configurator fixes, logging, segment handling, binary distribution, reliability, pairing, and discovery improvements, which fits the package's role as a small always-on household service rather than a library.
Adoption history
Adoption is centered on self-hosting and home-media users who want SponsorBlock behavior on devices such as Apple TV, Samsung TV, LG WebOS, Android TV, Chromecast, Roku, Fire TV, game consoles, and other YouTube TV clients listed by the project. The README also points to a Home Assistant add-on, showing use as part of a home automation stack.
Package-manager exposure through Homebrew and Nix made the tool easier to install outside Docker, while the upstream README also advertises container images and GitHub Container Registry/Docker Hub badges.
How it is used
The normal usage pattern is to run iSponsorBlockTV on a machine with access to youtube.com, pair it with a YouTube TV client through auto discovery or a manual TV code, and let it watch playback state so it can skip SponsorBlock segments or handle YouTube ad prompts.
Its configuration and credentials are intentionally the same local JSON file because pairing data and device settings are part of the same long-running service setup.
Why package nerds care
For package nerds, iSponsorBlockTV is an example of a browser-extension idea escaping into a daemon-like CLI package. It wraps a web-community data source, YouTube lounge-style device control, SSDP discovery, async Python networking, and a Textual configurator into something that can be installed like a normal Unix tool.
The package is also interesting because it targets consumer TV clients rather than desktop browsers, so its value comes from bridging mismatched ecosystems instead of providing a large API surface.
Timeline
- 2022: v0.1 was published on GitHub.
- 2023: v2.0.0 marked the V2 release.
- 2024: v2.2.0 added binary availability and reliability work.
- 2025: v2.3.x and v2.5.x releases continued pairing, configurator, and device-connection fixes.
- 2026: v2.9.0 included pairing and Chromecast discovery improvements.
Related projects
- SponsorBlock supplies the crowd-sourced segment data that gives the project its purpose.
- pyytlounge is used to interact with YouTube TV clients, while aiohttp, asyncio, async-cache, Textual, and ssdp support the network service, configurator, and discovery pieces.
- A Home Assistant add-on builds on the project for appliance-style deployment.
Sources
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for isponsorblocktv. Nucleus package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
$iSPBTV_data_dir/config.jsonappdirs user_data_dir('iSponsorBlockTV', 'dmunozv04')/config.json
Credential files
Credential-bearing paths to review before unattended agent runs.
- Unix
$iSPBTV_data_dir/config.jsonappdirs user_data_dir('iSponsorBlockTV', 'dmunozv04')/config.json
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
iSponsorBlockTV | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version2.10.0
manager updated2026-07-14
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:isponsorblocktv |
|---|---|
| Version | 2.10.0 |
| Package manager | Homebrew |
| Homepage | https://github.com/dmunozv04/iSponsorBlockTV |
| Last updated | 2026-07-14T15:27:28Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
isponsorblocktv
nix profile install nixpkgs#isponsorblocktv- normalized package name match
- Matched by: Isponsorblocktv
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- pkg.so package database
- pkgdb category and tag curation