iSponsorBlockTV

2.7.0 verified Fri May 01 auth: no python

A SponsorBlock client for YouTube TV clients (e.g., smart TVs, game consoles) that skips sponsor segments. Current version 2.7.0, requires Python >=3.9. Released roughly monthly.

pip install isponsorblocktv

Common errors

error ModuleNotFoundError: No module named 'isponsorblocktv' ↓

cause Library not installed or wrong case in import.

fix

Install with 'pip install isponsorblocktv' and import as 'from isponsorblocktv import iSponsorBlockTV'.

error AttributeError: module 'isponsorblocktv' has no attribute 'iSponsorBlockTV' ↓

cause Importing the module incorrectly, e.g., 'import isponsorblocktv' instead of the class.

fix

Use 'from isponsorblocktv import iSponsorBlockTV'.

error RuntimeError: You must pair a device before using this library ↓

cause The device has not been paired with YouTube TV.

fix

Use the pyytlounge library to pair a device or set up pairing via config.

Warnings

gotcha The library requires a YouTube TV account and device pairing; it does not work with standard YouTube accounts. ↓

fix Ensure you have a YouTube TV (TV-connected) account and have paired a device using the pyytlounge library.

breaking Version 2.0.0 introduced breaking changes: replaced synchronous API with async, changed class names and method signatures. ↓

fix Upgrade to >=2.0.0 and rewrite code to use async/await; import from isponsorblocktv instead of the old module.

deprecated The 'set_auto_play_mode' method was removed in v2.5.0. ↓

fix Use 'auto_play_mode' property instead.

gotcha Minimum Python version is 3.9; running on 3.8 or earlier will fail. ↓

fix Upgrade Python to 3.9+.

Imports

iSponsorBlockTV

from isponsorblocktv import iSponsorBlockTV

The main class for the client.

Quickstart

Basic usage to connect and start skipping sponsors.

import asyncio
from isponsorblocktv import iSponsorBlockTV

async def main():
    client = iSponsorBlockTV(user='your_user_id', password='your_password', device_name='MyDevice')
    await client.connect()
    await client.start()

asyncio.run(main())