iSponsorBlockTV
Skip sponsor segments in YouTube videos playing on an Apple TV.
This project is written in asycronous python and should be pretty quick.
Installation
Docker
WIP
From source
You need to install python first, and to make it available in your PATH. After, clone the repo. Then you need to download the dependencies with pip: python3 -m pip install -r requirements.txt
Lastly, run main.py
Setup
You need to retrieve airplay keys to be able to connect to the Apple TV. (It will be made simpler in the future) For now, use atvremote
, a script included in pyatv:
- atvremote scan
- atvremote pair –protocol airplay –id
identifier you got on the previous step
Get YouTube api key
Edit config.json.template and save it as config.json
Usage
Run iSponsorBLockTV in the same network as the Apple TV.
It connect to the Apple TV, watch its activity and skip any sponsor segment using the SponsorBlock API.
The last 5 videos’ segments are cached to limit the number on queries on SponsorBlock and YouTube.
To exit press ENTER
Libraries used
- pyatv Used to connect to the Apple TV
- [asyncio] and [aiohttp]
- [async_lru]
- [json]
Contributing
- Fork it (https://github.com/dmunozv04/iSponsorBlockTV/fork)
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Contributors
- dmunozv04 – creator and maintainer