otty / dotfiles

All tools/youtube-dl

youtube-dl

A command-line program to download videos from YouTube.com and a few more sites.

Detected by youtube-dl | macOS, Linux, Windows |ytdl-org.github.io

Sync it youtube-dl.toml

Sync rules

What travels, what stays, what never leaves

Synced3 paths, copied whole to your other machines

~/.config/youtube-dl/config

~/youtube-dl.conf

%APPDATA%/youtube-dl/config.txt

Stays on this machineInside a file that otherwise syncs

~/.config/youtube-dl/configlines starting with --cache-dir, --cookies

…

--no-mtime

--restrict-filenames

--output ~/Movies/%(uploader)s/%(title)s.%(ext)s

--cache-dir /Users/octocat/.cache/youtube-dlmachine-local

--ffmpeg-location /opt/homebrew/bin/ffmpeg

--cookies /Users/octocat/.config/youtube-dl/cookies.txtmachine-local

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

~/youtube-dl.conflines starting with --cache-dir, --cookies

# C:\Users\octocat\youtube-dl.conf

--no-mtime

--restrict-filenames

--cache-dir C:\Users\octocat\AppData\Local\youtube-dlmachine-local

--ffmpeg-location C:\Users\octocat\scoop\apps\ffmpeg\current\bin

--cookies C:\Users\octocat\youtube-dl-cookies.txtmachine-local

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

%APPDATA%/youtube-dl/config.txtlines starting with --cache-dir, --cookies

…

--no-mtime

--restrict-filenames

--output C:\Users\octocat\Videos\%(title)s.%(ext)s

--cache-dir C:\Users\octocat\AppData\Local\youtube-dlmachine-local

--ffmpeg-location C:\Users\octocat\scoop\apps\ffmpeg\current\bin

--cookies C:\Users\octocat\AppData\Roaming\youtube-dl\cookies.txtmachine-local

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

~/.config/youtube-dl/configlines starting with --ffmpeg-location

…

--restrict-filenames

--output ~/Movies/%(uploader)s/%(title)s.%(ext)s

--cache-dir /Users/octocat/.cache/youtube-dl

--ffmpeg-location /opt/homebrew/bin/ffmpegmachine-local

--cookies /Users/octocat/.config/youtube-dl/cookies.txt

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

~/youtube-dl.conflines starting with --ffmpeg-location

…

--no-mtime

--restrict-filenames

--cache-dir C:\Users\octocat\AppData\Local\youtube-dl

--ffmpeg-location C:\Users\octocat\scoop\apps\ffmpeg\current\binmachine-local

--cookies C:\Users\octocat\youtube-dl-cookies.txt

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

%APPDATA%/youtube-dl/config.txtlines starting with --ffmpeg-location

…

--restrict-filenames

--output C:\Users\octocat\Videos\%(title)s.%(ext)s

--cache-dir C:\Users\octocat\AppData\Local\youtube-dl

--ffmpeg-location C:\Users\octocat\scoop\apps\ffmpeg\current\binmachine-local

--cookies C:\Users\octocat\AppData\Roaming\youtube-dl\cookies.txt

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Excluded1 path, state rather than configuration — never uploaded

[xdgCache]/youtube-dl/directory

Not a subtraction from the paths above: this is everything else youtube-dl writes in your home directory that is state, not configuration. It keeps a whole-home manager like chezmoi from sweeping those up, and it still holds if the synced paths are ever widened.

youtube-dl in your home directory Every rule on this page, by file

…

--no-mtime

--restrict-filenames

--output ~/Movies/%(uploader)s/%(title)s.%(ext)s

--cache-dir /Users/octocat/.cache/youtube-dlmachine-local

--ffmpeg-location /opt/homebrew/bin/ffmpeg

--cookies /Users/octocat/.config/youtube-dl/cookies.txtmachine-local

Each machine keeps its own copy of these.

…

--restrict-filenames

--output ~/Movies/%(uploader)s/%(title)s.%(ext)s

--cache-dir /Users/octocat/.cache/youtube-dl

--ffmpeg-location /opt/homebrew/bin/ffmpegmachine-local

--cookies /Users/octocat/.config/youtube-dl/cookies.txt

Each machine keeps its own copy of these.

# C:\Users\octocat\youtube-dl.conf

--no-mtime

--restrict-filenames

--cache-dir C:\Users\octocat\AppData\Local\youtube-dlmachine-local

--ffmpeg-location C:\Users\octocat\scoop\apps\ffmpeg\current\bin

--cookies C:\Users\octocat\youtube-dl-cookies.txtmachine-local

Each machine keeps its own copy of these.

…

--no-mtime

--restrict-filenames

--cache-dir C:\Users\octocat\AppData\Local\youtube-dl

--ffmpeg-location C:\Users\octocat\scoop\apps\ffmpeg\current\binmachine-local

--cookies C:\Users\octocat\youtube-dl-cookies.txt

Each machine keeps its own copy of these.

…

--no-mtime

--restrict-filenames

--output C:\Users\octocat\Videos\%(title)s.%(ext)s

--cache-dir C:\Users\octocat\AppData\Local\youtube-dlmachine-local

--ffmpeg-location C:\Users\octocat\scoop\apps\ffmpeg\current\bin

--cookies C:\Users\octocat\AppData\Roaming\youtube-dl\cookies.txtmachine-local

Each machine keeps its own copy of these.

…

--restrict-filenames

--output C:\Users\octocat\Videos\%(title)s.%(ext)s

--cache-dir C:\Users\octocat\AppData\Local\youtube-dl

--ffmpeg-location C:\Users\octocat\scoop\apps\ffmpeg\current\binmachine-local

--cookies C:\Users\octocat\AppData\Roaming\youtube-dl\cookies.txt

Each machine keeps its own copy of these.

· ~/.cache/youtube-dl/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/youtube-dl.tomlThe file this page is generated from

id = "youtube-dl"

name = "youtube-dl"

homepage = "https://ytdl-org.github.io/youtube-dl/"

description = "A command-line program to download videos from YouTube.com and a few more sites."

detect = ["youtube-dl"]

# README, CONFIGURATION section (github.com/ytdl-org/youtube-dl): the per-user

# file is ~/.config/youtube-dl/config on Linux and macOS, and on Windows either

# %APPDATA%\youtube-dl\config.txt or youtube-dl.conf in the user profile root.

# The last one resolves to the same place a consumer computes for ~/, so it is

# spelled with ~ rather than %USERPROFILE%. /etc/youtube-dl.conf is

# system-wide, not user-level, and is not listed.

paths = [

"~/.config/youtube-dl/config",

"~/youtube-dl.conf",

"%APPDATA%/youtube-dl/config.txt",

]

# --cache-dir defaults to $XDG_CACHE_HOME/youtube-dl (README, options), which

# is `[xdgCache]`: youtube_dl/cache.py takes

# `compat_getenv('XDG_CACHE_HOME', '~/.cache')` with no per-platform branch,

# so the dot path is what it uses on macOS and Windows as well, and the

# variable moves it everywhere.

exclude = ["[xdgCache]/youtube-dl/"]

# Login details go through --netrc and ~/.netrc, which is not youtube-dl's

# own file. Nothing the config file holds is a credential by itself.

secret = []

# The options file is re-read on every invocation.

side_effect = false

# One file under three names, so both rules name all three — the sibling check

# pairs paths by their last segment and cannot see that config, config.txt and

# youtube-dl.conf are the same thing. The file is a list of command-line

# options, one per line.

# --cache-dir is a directory the user picked and --cookies points at a jar that

# exists only here: both are worth keeping so they can rebuild this machine,

# and worth nothing on another.

[[machine_lines]]

file = [

"~/.config/youtube-dl/config",

"~/youtube-dl.conf",

"%APPDATA%/youtube-dl/config.txt",

]

match = { prefix = ["--cache-dir", "--cookies"] }

scope = "backup"

# --ffmpeg-location is where ffmpeg was installed, which follows from the OS

# and the architecture rather than from this box — hence its own rule, and a

# value shared across that machine class.

[[machine_lines]]

file = [

"~/.config/youtube-dl/config",

"~/youtube-dl.conf",

"%APPDATA%/youtube-dl/config.txt",

]

match = { prefix = ["--ffmpeg-location"] }

scope = "platform"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/youtube-dl. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits --cache-dir and --cookies for you — that part is Otty’s own sync, or a template you write by hand.