youtube-dl

### Global yt-dlp options for Eggman's YouTube library.

## Paths and Output
# New sources override the home path per line in channels.txt. This default
# keeps uncategorized/manual downloads safely inside the existing Plex root.
--paths 'home:/downloads/_Uncategorized'
--output '%(upload_date>%Y-%m-%d)s - %(title)s [%(id)s].%(ext)s'

## Geo Restriction
--geo-bypass

## Video Selection
# Conservative fallback for manually added sources. Generated sources carry
# their own reviewed per-line cap and the first rollout also resolves to three.
--playlist-end '3'
# Exclude current, upcoming, and archived livestreams. Channel sources must
# also use their explicit /videos tab; the URL predicate is a second guard
# against Shorts entering from mixed playlists.
--match-filter "live_status='not_live' & original_url!*='/shorts/'"

## Download Options
--abort-on-unavailable-fragment
--playlist-reverse

## Filesystem Options
--windows-filenames
# Keep yt-dlp's default .part suffix so Plex and Tdarr do not ingest a file
# before the download and post-processing steps have completed.
--no-cache-dir

## Verbosity / Simulation Options
--ignore-no-formats-error
--newline
--progress-delta '10'

## Workarounds
--sleep-requests '1'

## Video Format Options
# Prefer exactly 720p H.264 plus AAC audio for Apple TV. If 720p is absent,
# take the smallest available resolution above 720p (normally 1080p) for Tdarr
# to downscale. A lower resolution is used only when no 720p-or-higher source
# exists.
--format 'bv*[height=720][vcodec^=avc1]+ba[acodec^=mp4a]/b[height=720][vcodec^=avc1][acodec^=mp4a]/bv*[height>=720]+ba/b[height>=720]/bv*[height<720]+ba/b[height<720]'
--format-sort '+res,codec:avc:m4a'
--merge-output-format 'mp4'

## Subtitle Options
--sub-langs 'all,-live_chat'

## Post-Processing Options
--embed-subs
--embed-thumbnail
--embed-metadata
--convert-subs 'srt'

## SponsorBlock Options
# Remove embedded ads, creator sales pitches, and engagement requests when
# community timing data exists. Other reported segments remain chapter marks.
--sponsorblock-remove 'sponsor,selfpromo,interaction'
--sponsorblock-mark 'all'

Args.conf