{"id":23902,"library":"isponsorblocktv","title":"iSponsorBlockTV","description":"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.","status":"active","version":"2.7.0","language":"python","source_language":"en","source_url":"https://github.com/dmunozv04/iSponsorBlockTV","tags":["ad-blocking","sponsorblock","youtube","youtube-tv"],"install":[{"cmd":"pip install isponsorblocktv","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for YouTube TV lounge API communication.","package":"pyytlounge","optional":false},{"reason":"Async HTTP client for SponsorBlock API calls.","package":"aiohttp","optional":false}],"imports":[{"note":"The main class for the client.","symbol":"iSponsorBlockTV","correct":"from isponsorblocktv import iSponsorBlockTV"}],"quickstart":{"code":"import asyncio\nfrom isponsorblocktv import iSponsorBlockTV\n\nasync def main():\n    client = iSponsorBlockTV(user='your_user_id', password='your_password', device_name='MyDevice')\n    await client.connect()\n    await client.start()\n\nasyncio.run(main())","lang":"python","description":"Basic usage to connect and start skipping sponsors."},"warnings":[{"fix":"Ensure you have a YouTube TV (TV-connected) account and have paired a device using the pyytlounge library.","message":"The library requires a YouTube TV account and device pairing; it does not work with standard YouTube accounts.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade to >=2.0.0 and rewrite code to use async/await; import from isponsorblocktv instead of the old module.","message":"Version 2.0.0 introduced breaking changes: replaced synchronous API with async, changed class names and method signatures.","severity":"breaking","affected_versions":"<2.0.0 vs >=2.0.0"},{"fix":"Use 'auto_play_mode' property instead.","message":"The 'set_auto_play_mode' method was removed in v2.5.0.","severity":"deprecated","affected_versions":">=2.5.0"},{"fix":"Upgrade Python to 3.9+.","message":"Minimum Python version is 3.9; running on 3.8 or earlier will fail.","severity":"gotcha","affected_versions":">=2.3.0,<3.9"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install with 'pip install isponsorblocktv' and import as 'from isponsorblocktv import iSponsorBlockTV'.","cause":"Library not installed or wrong case in import.","error":"ModuleNotFoundError: No module named 'isponsorblocktv'"},{"fix":"Use 'from isponsorblocktv import iSponsorBlockTV'.","cause":"Importing the module incorrectly, e.g., 'import isponsorblocktv' instead of the class.","error":"AttributeError: module 'isponsorblocktv' has no attribute 'iSponsorBlockTV'"},{"fix":"Use the pyytlounge library to pair a device or set up pairing via config.","cause":"The device has not been paired with YouTube TV.","error":"RuntimeError: You must pair a device before using this library"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}