https://github.com/dmunozv04/iSponsorBlockTV
SponsorBlock client for all YouTube TV clients.
https://github.com/dmunozv04/iSponsorBlockTV
appletv chromecast python roku sponsorblock tizen-tv youtube
Last synced: 20 days ago
JSON representation
SponsorBlock client for all YouTube TV clients.
- Host: GitHub
- URL: https://github.com/dmunozv04/iSponsorBlockTV
- Owner: dmunozv04
- License: gpl-3.0
- Created: 2022-01-15T18:26:33.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-16T17:25:33.000Z (6 months ago)
- Last Synced: 2024-10-29T14:53:18.948Z (6 months ago)
- Topics: appletv, chromecast, python, roku, sponsorblock, tizen-tv, youtube
- Language: Python
- Homepage:
- Size: 321 KB
- Stars: 2,456
- Watchers: 15
- Forks: 102
- Open Issues: 54
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# iSponsorBlockTV
[](https://ghcr.io/dmunozv04/isponsorblocktv)
[](https://hub.docker.com/r/dmunozv04/isponsorblocktv/)
[](https://github.com/dmunozv04/iSponsorBlockTV/releases/latest)
[](https://github.com/dmunozv04/isponsorblocktv)
Skip sponsor segments in YouTube videos playing on a YouTube TV device (see
below for compatibility details).
This project is written in asynchronous python and should be pretty quick.
## Installation
Check the [wiki](https://github.com/dmunozv04/iSponsorBlockTV/wiki/Installation)
## 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 | ✅ |
## Usage
Run iSponsorBlockTV on a computer that has network access.
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 application.
It connects to the device, watches its activity and skips any sponsor segment
using the [SponsorBlock](https://sponsor.ajay.app/) API.
It can also skip/mute YouTube ads.
## Libraries used
- [pyytlounge](https://github.com/FabioGNR/pyytlounge) Used to interact with the
device
- asyncio and [aiohttp](https://github.com/aio-libs/aiohttp)
- [async-cache](https://github.com/iamsinghrajat/async-cache)
- [Textual](https://github.com/textualize/textual/) Used for the amazing new
graphical configurator
- [ssdp](https://github.com/codingjoe/ssdp) Used for auto discovery
## Projects using this project
- [Home Assistant Addon](https://github.com/bertybuttface/addons/tree/main/isponsorblocktv)
## Contributing
1. Fork it ()
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
- [dmunozv04](https://github.com/dmunozv04) - creator and maintainer
- [HaltCatchFire](https://github.com/HaltCatchFire) - updated dependencies and
improved skip logic
- [Oxixes](https://github.com/oxixes) - added support for channel whitelist and
minor improvements
## License
[](https://www.gnu.org/licenses/gpl-3.0.en.html)