Files
hassio-addons/sponsorblockcast
copilot-swe-agent[bot] 8a0f15413c Add My Home Assistant repository button to all addon READMEs
Add the "Add repository to my Home Assistant" blue button to all
addon README files that were missing it. This makes it easier for
new HA users to add the repository with a single click.

Updated 59 addon READMEs:
- 51 with standard Installation section format
- 8 with non-standard or missing Installation sections

Co-authored-by: alexbelgium <44178713+alexbelgium@users.noreply.github.com>
2026-02-23 09:02:12 +00:00
..
2025-11-19 21:35:05 +01:00
2026-01-10 20:12:24 +01:00
2026-02-04 15:59:55 +01:00
2025-08-31 23:06:36 +00:00
2025-08-31 23:06:36 +00:00
2026-02-22 23:10:24 +00:00

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 add-ons repository to your home assistant instance (in supervisor addons store at top right, or click button below if you have configured my HA) Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.
  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