Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/yt-dlp/yt-dlp/llms.txt

Use this file to discover all available pages before exploring further.

Make chapter entries for, or remove various segments (sponsor, introductions, etc.) from downloaded YouTube videos using the SponsorBlock API

​
Mark Segments

​
--sponsorblock-mark
string
SponsorBlock categories to create chapters for, separated by commasAvailable categories:
  • sponsor - Paid promotion
  • intro - Intro/intermission
  • outro - Outro/endcards
  • selfpromo - Self promotion
  • preview - Preview/recap
  • filler - Filler tangent
  • interaction - Interaction reminder
  • music_offtopic - Off-topic music
  • hook - Attention grabber
  • poi_highlight - Point of interest highlight
  • chapter - Chapter marker
  • all - All categories
  • default - Same as all
You can prefix the category with a ”-” to exclude it.See SponsorBlock Wiki for descriptions of the categories.Example:
yt-dlp --sponsorblock-mark all,-preview URL
yt-dlp --sponsorblock-mark "sponsor,intro,outro" URL

​
Remove Segments

​
--sponsorblock-remove
string
SponsorBlock categories to be removed from the video file, separated by commasIf a category is present in both mark and remove, remove takes precedence.The syntax and available categories are the same as for --sponsorblock-mark except that:
  • default refers to “all,-filler”
  • poi_highlight and chapter are not available
Example:
yt-dlp --sponsorblock-remove sponsor,intro URL
yt-dlp --sponsorblock-remove default URL

​
Chapter Title Template

​
--sponsorblock-chapter-title
string
default:"[SponsorBlock]: %(category_names)l"
An output template for the title of the SponsorBlock chapters created by --sponsorblock-markAvailable fields:
  • start_time - Start time of the segment
  • end_time - End time of the segment
  • category - Category code
  • categories - List of category codes
  • name - Segment name
  • category_names - List of category names
Example:
yt-dlp --sponsorblock-mark all --sponsorblock-chapter-title "[%(category)s]" URL

​
Disable SponsorBlock

​
--no-sponsorblock
flag
Disable both --sponsorblock-mark and --sponsorblock-remove

​
Custom API Location

​
--sponsorblock-api
string
default:"https://sponsor.ajay.app"
SponsorBlock API locationExample:
yt-dlp --sponsorblock-api "https://sponsor.ajay.app" URL