Home assistant add-on: CastSponsorSkip

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

About

CastSponsorSkip is a Go program that skips sponsored YouTube content and skippable ads on all local Chromecasts, using the SponsorBlock API. It was inspired by CastBlock but written from scratch to avoid some of its pitfalls (see Differences from CastBlock).

This app is developed by @gabe565 here : https://github.com/gabe565/CastSponsorSkip

Feedback from @diamant-x :

Special attention that it only works when casting to a chromecast a youtube video. It mostly removes manual interaction, can't magically skip ads when they are forced to be viewed. Also, it doesn't seem to work when playing on an android tv through native youtube app, which would be a great addition, or on a smartphone.

Configuration

This addon has no web interface - all configuration is done through addon options. The addon automatically discovers local Chromecast devices and monitors YouTube playback to skip sponsored content.

Options

Option	Type	Default	Description
`CSS_CATEGORIES`	str	`sponsor, intro, outro, selfpromo`	SponsorBlock categories to skip (comma-separated)
`CSS_DISCOVER_INTERVAL`	str		Device discovery interval
`CSS_MUTE_ADS`	bool		Mute ads instead of skipping
`CSS_PAUSED_INTERVAL`	str		Check interval when video is paused
`CSS_PLAYING_INTERVAL`	str		Check interval when video is playing
`CSS_YOUTUBE_API_KEY`	str		YouTube API key for enhanced features

Example Configuration

CSS_CATEGORIES: "sponsor, intro, outro, selfpromo, interaction"
CSS_MUTE_ADS: false
CSS_PAUSED_INTERVAL: "30s"
CSS_PLAYING_INTERVAL: "500ms"

Custom Scripts and Environment Variables

This addon supports custom script execution and environment variable injection:

Custom scripts: See Running Custom Scripts in Addons
Environment variables: See Add Environment Variables to your Addon

Additional Resources

For detailed configuration options, see: https://github.com/gabe565/CastSponsorSkip

Installation

The installation of this add-on is pretty straightforward and not different in comparison to installing any other Hass.io add-on.

Add my Hass.io add-ons repository to your Hass.io instance.
Install this add-on.
Click the Save button to store your configuration.
Start the add-on.
Check the logs of the add-on to see if everything went well.
Carefully configure the add-on to your preferences, see the official documentation for for that.

Support and issues

Addon : here App : https://github.com/gabe565/CastSponsorSkip

5.0 KiB Raw Blame History