erdnaxeli/castblock repository overview

⁠CastBlock

Skip sponsor segments in YouTube videos playing on a Chromecast.

This project is inspired by CastBlock by stephen304⁠. It was rewritten in Crystal and uses the HTTP API exposed by go-chromecast⁠ to be less CPU intensive.

The impact of CastBlock on the CPU should be almost zero, and only a few dozen of Mo on the memory.

The docker image supports amd64, arm and arm64 architectures. In particular it should run on all raspberry pi. If not, please open an issue :)

The amd64 and arm64 images are based on Alpine and weigh only 20Mo, but due to a missing cross compilation target⁠ the arm images use Debian and weights 47Mo.

⁠Usage

docker pull erdnaxeli/castblock:latest
docker run --rm --network host erdnaxeli/castblock [OPTIONS]

It will detect all Chromecast, watch their activity and skip any sponsor segment using the SponsorBlock⁠ API.

New devices are detected every 30s. Segments shorter that 5s cannot be skipped. The last 20 videos' segments are cached to limit the number on queries on SponsorBlock.

If you have any issue, please run CastBlock with the --debug flag, try to reproduce your problem and past the output in the issue: docker run --rm --network host erdnaxeli/castblock --debug.

Available options:

• --debug: run the app with the debug logs.
• --offset: set an offset to use before the end of the segment, in seconds. An offset of 2 means that it will seek 2s before the end of the segmend.
• --category: specify the category of segments⁠ to skip. It can be repeated to specify many categories. Default to "sponsor".

All options can also be read from the environment variables, to work with docker-compose:

• DEBUG=true
• OFFSET=1
• CATEGORIES=sponsor,interaction