# 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 ```sh sudo av install brew:isponsorblocktv ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install isponsorblocktv ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#isponsorblocktv ``` Evidence: nixpkgs package indexes: pkgs/by-name/is/isponsorblocktv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:isponsorblocktv - **Package manager:** Homebrew - **Version:** 2.10.0 - **Source summary:** SponsorBlock client for all YouTube TV clients - **Homepage:** - **Last updated:** 2026-07-14T15:27:28Z - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - iSponsorBlockTV (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 2.10.0 ## 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 Notes 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. ## 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 - Unix: $iSPBTV_data_dir/config.json, appdirs user_data_dir('iSponsorBlockTV', 'dmunozv04')/config.json ## Credential files - Unix: $iSPBTV_data_dir/config.json, appdirs user_data_dir('iSponsorBlockTV', 'dmunozv04')/config.json ## Other Package-Manager Records - Nix - isponsorblocktv: normalized package name match | nixpkgs package indexes: pkgs/by-name/is/isponsorblocktv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Combined YAML source View the package source record on GitHub. [combined/isponsorblocktv.yml](https://github.com/mxcl/pkgdb/blob/main/combined/isponsorblocktv.yml) ## Sources - pkg.so package database - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph