youtube-dl 命令

常用示例

说明

youtube-dl is a command-line program to download videos from YouTube and hundreds of other video platforms. It supports playlists, channels, and individual videos, with options for format selection, audio extraction, and subtitle downloading. The output filename can be customized using templates with metadata variables. Configuration options can be stored in ~/.config/youtube-dl/config or /etc/youtube-dl.conf for persistent settings. The tool requires Python and works on Linux, macOS, and Windows.

参数

-f, --format _format_

Video format code. Use -F to list available formats.

-F, --list-formats

List all available formats for the video.

-o, --output _template_

Output filename template with variables like %(title)s, %(ext)s.

-x, --extract-audio

Extract audio track only.

--audio-format _format_

Audio format for extraction: mp3, aac, flac, wav, etc.

--audio-quality _quality_

Audio quality: 0 (best) to 9 (worst), or specific bitrate.

-a, --batch-file _file_

Read URLs from a file (one per line).

-c, --continue

Resume partially downloaded files.

-i, --ignore-errors

Continue on errors (useful for playlists).

--playlist-start _num_

Start playlist at video number.

--playlist-end _num_

End playlist at video number.

--write-sub

Download subtitles.

--sub-lang _langs_

Subtitle languages to download.

-j, --dump-json

Print video info as JSON without downloading.

--cookies _FILE_

Read cookies from a Netscape cookie file for authenticated access.

--proxy _URL_

Use specified HTTP/HTTPS/SOCKS proxy.

--geo-bypass

Bypass geographic restriction via faking X-Forwarded-For header.

-u _USER_, --username _USER_

Login with account username.

-p _PASS_, --password _PASS_

Login with account password.

-v, --verbose

Print debug information.

-h, --help

Display help message.