Advanced Skip Options

From SponsorBlock
Jump to navigation Jump to search

Advanced skip options can be used to change the skip options depending on certain criteria of the submission itself.

Example:

// Skip sponsors at the start of the video
if time.start < 1 and time.end < 10 and category == "sponsor"
Auto Skip

Each block consists of the word "if" along with a number of conditions with "and" in the middle.

The following attributes are supported:

  1. time.start
  2. time.end
  3. timeduration
  4. time.startPercent
  5. time.endPercent
  6. time.durationPercent
  7. category
  8. actionType
  9. chapter.name (the title for chapters)
  10. chapter.source (to separate sponsorblock chapters from youtube chapters)
  11. channel.id (ID starting with UC)
  12. channel.name (plain text name with spaces)

The following operators are supported:

  1. <
  2. <=
  3. >
  4. >=
  5. ==
  6. != (not equal)
  7. *= (contains text ignore case)
  8. !*= (not contains ignore case)
  9. ~= (matches regex)
  10. ~i= (matches regex ignore case)
  11. !~= (doesn't match regex)
  12. !~i= (doesn't match regex ignore case)

The following actions are supported:

  1. Disabled
  2. Show Overlay
  3. Manual Skip
  4. Auto Skip

The following categories are supported:

  1. sponsor
  2. selfpromo
  3. exclusive_access
  4. interaction
  5. poi_highlight
  6. intro
  7. outro
  8. preview
  9. filler
  10. chapter
  11. music_offtopic

The following source values are supported:

  1. server
  2. youtube
  3. autogenerated
  4. local

More examples

// Auto skip chapters that contain the word bloopers (case insensitive)
if category == "chapter" and chapter.name *= "bloopers"
Auto Skip

// Auto skip chapters that start with the word Intro or intro
if category == "chapter" and chapter.name ~= "^[Ii]ntro"
Auto Skip

// Auto skip chapters that start with the word Intro or intro but only if they are made by the YouTuber
if category == "chapter" and chapter.name ~= "^[Ii]ntro" and chapter.source == "youtube"
Auto Skip

// Auto skip chapters that start with the word Intro or intro but only if they are submitted by a SponsorBlock user
if category == "chapter" and chapter.name ~= "^[Ii]ntro" and chapter.source == "server"
Auto Skip

// Auto skip preview/recap on this specific channel
if category == "preview" and channel.id == "UCX8wm5-NEzN-eL-DNcsRRJA"
Auto Skip

// Auto skip intros on channels with names containing trains
if category == "intro" and channel.name *= "trains"
Auto Skip