-
Notifications
You must be signed in to change notification settings - Fork 0
Advanced Custom yt dlp options
Warning: Custom yt-dlp options are powerful but can easily break Pinchfork's internal tracking of your media. Bug reports that can only be reproduced with custom options will likely be closed. Use at your own risk.
Custom options only apply to media downloading — they cannot affect indexing or other internal operations.
Inside your Pinchfork config directory, there is an extras/yt-dlp-configs/ directory. All yt-dlp config files go here. See the yt-dlp configuration documentation for the config file format.
base-config.txt is the root config file. Options here apply to every download operation.
You can apply a config to all downloads belonging to a specific Media Profile, Source, or Media Item. Scoped config files must be created manually with a specific naming scheme:
- Media Profile:
media-profile-{id}-config.txt - Source:
source-{id}-config.txt - Media Item:
media-item-{id}-config.txt
For example, a custom config for Source ID 23 would be at:
<config directory>/extras/yt-dlp-configs/source-23-config.txt
Options from multiple config files are combined. When the same option appears in multiple files, the most specific one wins:
Media Item > Source > Media Profile > base config
See the yt-dlp documentation on --config-locations for details.