Files
hassio-addons/sponsorblockcast

Home assistant add-on: CastSponsorSkip

I maintain this and other Home Assistant add-ons in my free time: keeping up with upstream changes, HA changes, and testing on real hardware takes a lot of time (and some money). I use around 5-10 of my >110 addons so regularly I install test machines (and purchase some test services such as vpn) that I don't use myself to troubleshoot and improve the addons

If this add-on saves you time or makes your setup easier, I would be very grateful for your support!

Buy me a coffee Donate via PayPal

Addon informations

Version Ingress Arch

Codacy Badge GitHub Super-Linter Builder

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

Stargazers repo roster for @alexbelgium/hassio-addons

downloads evolution

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 in the CastSponsorSkip repository.

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 5m Interval to restart the DNS discovery client
CSS_DEVICES str [] Comma-separated list of device addresses; disables discovery
CSS_MUTE_ADS bool true Mutes the device while an ad is playing
CSS_PAUSED_INTERVAL str 1m Poll interval when the Cast device is paused
CSS_PLAYING_INTERVAL str 500ms Poll interval when the Cast device is playing
CSS_SKIP_SPONSORS bool true Toggle SponsorBlock segment skipping; if disabled only YouTube ads are skipped
CSS_YOUTUBE_API_KEY str `` YouTube API key for fallback video identification

Example Configuration

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

Custom Scripts and Environment Variables

This addon supports custom script execution and environment variable injection:

Additional Resources

For detailed configuration options, see CastSponsorSkip.

Installation

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

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

Support and issues

Addon : here App : CastSponsorSkip