YouTube & Video Downloader Skill

YouTube 与视频下载 Skill

Download videos and audio from YouTube and 1000+ other websites using yt-dlp, the most powerful and actively maintained YouTube downloader.

使用 yt-dlp（功能最强大且仍在积极维护的 YouTube 下载器）从 YouTube 和其他 1000 多个网站下载视频和音频。

When to Use This Skill

何时使用此 Skill

Use when you need to:

Download YouTube videos in any quality (144p to 8K, HDR, 60fps)
Extract audio from videos (MP3, M4A, FLAC, WAV, Opus)
Download entire playlists or channels
Get video subtitles/captions in multiple languages
Download live streams or premieres
Archive content before it's deleted
Download from 1000+ websites (not just YouTube)
Batch download multiple videos
Download with custom naming and organization
Extract video metadata and thumbnails

当你需要：

下载任意画质（从 144p 到 8K、HDR、60fps）的 YouTube 视频
从视频中提取音频（MP3、M4A、FLAC、WAV、Opus）
下载整个播放列表或频道
获取多种语言的视频字幕或说明文字
下载直播或首播内容
在内容被删除前将其归档
从 1000 多个网站下载内容（不限于 YouTube）
批量下载多个视频
使用自定义命名和整理方式下载
提取视频元数据和缩略图

Supported Websites (1000+)

支持的网站（1000 多个）

Video Platforms

视频平台

YouTube (videos, playlists, channels, shorts, live streams)
Vimeo, Dailymotion, Twitter/X, Facebook
TikTok, Instagram (videos, reels, stories)
Twitch (VODs, clips, live streams)
Reddit (v.redd.it videos)
Pornhub (videos)
Youporn (videos)

YouTube（视频、播放列表、频道、Shorts、直播）
Vimeo、Dailymotion、Twitter/X、Facebook
TikTok、Instagram（视频、Reels、Stories）
Twitch（VOD、片段、直播）
Reddit（v.redd.it 视频）
Pornhub（视频）
Youporn（视频）

Educational

教育平台

Coursera, Udemy, Khan Academy
edX, Pluralsight, LinkedIn Learning

Coursera、Udemy、Khan Academy
edX、Pluralsight、LinkedIn Learning

News & Media

新闻与媒体

CNN, BBC, NBC, CBS
ESPN, Sky Sports

CNN、BBC、NBC、CBS
ESPN、Sky Sports

And 1000+ more...

以及其他 1000 多个网站……

Installation

安装

yt-dlp requires Python 3.7+ and ffmpeg for format conversion:

bash

undefined

yt-dlp 需要 Python 3.7+，进行格式转换还需要 ffmpeg：

bash

undefined

Install yt-dlp (if not already installed)

pip install -U yt-dlp

Install ffmpeg (required for format conversion)

Ubuntu/Debian:

sudo apt install ffmpeg

macOS:

brew install ffmpeg

Verify installation

yt-dlp --version ffmpeg -version

undefined

yt-dlp --version ffmpeg -version

undefined

Basic Usage

基本用法

Download Best Quality Video

下载最佳画质视频

bash

yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"

bash

yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"

Download Best Quality Audio (as M4A)

下载最佳音质音频（M4A 格式）

bash

yt-dlp -f "bestaudio" "https://www.youtube.com/watch?v=VIDEO_ID"

bash

yt-dlp -f "bestaudio" "https://www.youtube.com/watch?v=VIDEO_ID"

Download and Convert to MP3

下载并转换为 MP3

bash

yt-dlp -x --audio-format mp3 --audio-quality 0 "https://www.youtube.com/watch?v=VIDEO_ID"

bash

yt-dlp -x --audio-format mp3 --audio-quality 0 "https://www.youtube.com/watch?v=VIDEO_ID"

Download Specific Quality

下载指定画质

bash

undefined

bash

undefined

1080p video with best audio

yt-dlp -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" "URL"

4K video

yt-dlp -f "bestvideo[height<=2160]+bestaudio/best" "URL"

720p video

yt-dlp -f "bestvideo[height<=720]+bestaudio/best[height<=720]" "URL"

undefined

yt-dlp -f "bestvideo[height<=720]+bestaudio/best[height<=720]" "URL"

undefined

Advanced Features

高级功能

Download Entire Playlist

下载整个播放列表

bash

yt-dlp "https://www.youtube.com/playlist?list=PLAYLIST_ID"

bash

yt-dlp "https://www.youtube.com/playlist?list=PLAYLIST_ID"

Download Playlist Range

下载播放列表范围

bash

undefined

bash

undefined

Videos 1-10

yt-dlp --playlist-start 1 --playlist-end 10 "PLAYLIST_URL"

Videos from #5 onwards

yt-dlp --playlist-start 5 "PLAYLIST_URL"

undefined

yt-dlp --playlist-start 5 "PLAYLIST_URL"

undefined

Download All Videos from Channel

下载频道中的所有视频

bash

yt-dlp "https://www.youtube.com/@ChannelName/videos"

bash

yt-dlp "https://www.youtube.com/@ChannelName/videos"

Download with Subtitles

下载字幕

bash

undefined

bash

undefined

Download all available subtitles

yt-dlp --write-subs --write-auto-subs --sub-langs "en,es,fr" "URL"

Download and embed subtitles

yt-dlp --write-subs --embed-subs --sub-langs "en.*" "URL"

Download only subtitles (no video)

yt-dlp --skip-download --write-subs --write-auto-subs "URL"

undefined

yt-dlp --skip-download --write-subs --write-auto-subs "URL"

undefined

Custom Naming and Organization

自定义命名和整理

bash

undefined

bash

undefined

Custom filename template

yt-dlp -o "%(uploader)s/%(playlist)s/%(title)s.%(ext)s" "PLAYLIST_URL"

By date uploaded

yt-dlp -o "%(upload_date)s - %(title)s.%(ext)s" "URL"

With video ID

yt-dlp -o "%(title)s [%(id)s].%(ext)s" "URL"

undefined

yt-dlp -o "%(title)s [%(id)s].%(ext)s" "URL"

undefined

Download Thumbnails

下载缩略图

bash

undefined

bash

undefined

Download and embed thumbnail

yt-dlp --write-thumbnail --embed-thumbnail "URL"

Download thumbnail only

yt-dlp --write-thumbnail --skip-download "URL"

undefined

yt-dlp --write-thumbnail --skip-download "URL"

undefined

Download Metadata

下载元数据

bash

undefined

bash

undefined

Write metadata to JSON file

yt-dlp --write-info-json "URL"

Write metadata to description file

yt-dlp --write-description "URL"

undefined

yt-dlp --write-description "URL"

undefined

Quality Selection Guide

画质选择指南

Video Quality Formats

视频画质格式

bash

undefined

bash

undefined

Best overall quality (may be WebM)

yt-dlp -f "bestvideo+bestaudio/best" "URL"

Best MP4 format (most compatible)

yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" "URL"

4K (2160p) maximum

yt-dlp -f "bestvideo[height<=2160]+bestaudio" "URL"

1080p maximum

yt-dlp -f "bestvideo[height<=1080]+bestaudio" "URL"

720p maximum

yt-dlp -f "bestvideo[height<=720]+bestaudio" "URL"

60fps preferred

yt-dlp -f "bestvideo[fps>30]+bestaudio/best" "URL"

undefined

yt-dlp -f "bestvideo[fps>30]+bestaudio/best" "URL"

undefined

Audio Quality Formats

音频画质格式

bash

undefined

bash

undefined

Best audio quality (extract as M4A)

yt-dlp -f "bestaudio" "URL"

Extract as MP3 (best quality)

yt-dlp -x --audio-format mp3 --audio-quality 0 "URL"

Extract as FLAC (lossless)

yt-dlp -x --audio-format flac "URL"

Extract as Opus (efficient)

yt-dlp -x --audio-format opus "URL"

Extract as WAV (uncompressed)

yt-dlp -x --audio-format wav "URL"

undefined

yt-dlp -x --audio-format wav "URL"

undefined

List Available Formats

列出可用格式

Before downloading, check what formats are available:

bash

yt-dlp -F "URL"

This shows all available video and audio streams with:

Format ID
Extension
Resolution
FPS
Codec
File size
Bitrate

Then download specific format:

bash

yt-dlp -f FORMAT_ID "URL"

下载前，先检查有哪些可用格式：

bash

yt-dlp -F "URL"

这会显示所有可用的视频和音频流，包括：

格式 ID
扩展名
分辨率
FPS
编解码器
文件大小
比特率

然后下载指定格式：

bash

yt-dlp -f FORMAT_ID "URL"

Batch Download

批量下载

From File

从文件下载

Create a text file with URLs (one per line):

https://www.youtube.com/watch?v=VIDEO1
https://www.youtube.com/watch?v=VIDEO2
https://www.youtube.com/watch?v=VIDEO3

Download all:

bash

yt-dlp -a urls.txt

创建一个包含 URL 的文本文件（每行一个）：

https://www.youtube.com/watch?v=VIDEO1
https://www.youtube.com/watch?v=VIDEO2
https://www.youtube.com/watch?v=VIDEO3

下载全部内容：

bash

yt-dlp -a urls.txt

With Archive

使用归档文件

Track downloaded videos to avoid re-downloading:

bash

yt-dlp --download-archive archive.txt "PLAYLIST_URL"

This creates

archive.txt

with IDs of downloaded videos. On subsequent runs, yt-dlp skips already downloaded videos.

跟踪已下载的视频，避免重复下载：

bash

yt-dlp --download-archive archive.txt "PLAYLIST_URL"

这会创建

archive.txt

，其中记录已下载视频的 ID。后续运行时，yt-dlp 会跳过已下载的视频。

Filtering and Selection

过滤和选择

Date Filters

日期过滤

bash

undefined

bash

undefined

Videos from 2024

yt-dlp --dateafter 20240101 "CHANNEL_URL"

Videos before 2023

yt-dlp --datebefore 20230101 "CHANNEL_URL"

Videos between dates

yt-dlp --dateafter 20230101 --datebefore 20231231 "CHANNEL_URL"

undefined

yt-dlp --dateafter 20230101 --datebefore 20231231 "CHANNEL_URL"

undefined

View Count Filters

播放量过滤

bash

undefined

bash

undefined

Videos with 1M+ views

yt-dlp --match-filter "view_count > 1000000" "CHANNEL_URL"

Videos with less than 10K views

yt-dlp --match-filter "view_count < 10000" "CHANNEL_URL"

undefined

yt-dlp --match-filter "view_count < 10000" "CHANNEL_URL"

undefined

Duration Filters

时长过滤

bash

undefined

bash

undefined

Videos longer than 10 minutes

yt-dlp --match-filter "duration > 600" "PLAYLIST_URL"

Videos shorter than 5 minutes

yt-dlp --match-filter "duration < 300" "PLAYLIST_URL"

undefined

yt-dlp --match-filter "duration < 300" "PLAYLIST_URL"

undefined

Live Streams

直播

Download Live Stream

下载直播流

bash

undefined

bash

undefined

Wait for stream to start and download

yt-dlp --wait-for-video 60 "LIVE_STREAM_URL"

Download stream as it's happening (may be incomplete if interrupted)

yt-dlp "LIVE_STREAM_URL"

undefined

yt-dlp "LIVE_STREAM_URL"

undefined

Rate Limiting and Network Options

速率限制与网络选项

bash

undefined

bash

undefined

Limit download speed (e.g., 1MB/s)

yt-dlp --limit-rate 1M "URL"

Set number of retries

yt-dlp --retries 10 "URL"

Wait between downloads (in seconds)

yt-dlp --sleep-interval 5 "PLAYLIST_URL"

Use specific proxy

yt-dlp --proxy "http://proxy.server:port" "URL"

Use cookies from browser (bypass age restrictions)

yt-dlp --cookies-from-browser chrome "URL"

undefined

yt-dlp --cookies-from-browser chrome "URL"

undefined

Geo-Restriction Bypass

绕过地理限制

bash

undefined

bash

undefined

Use proxy

yt-dlp --proxy "socks5://proxy.server:1080" "URL"

Use specific geo-bypass country

yt-dlp --geo-bypass-country US "URL"

undefined

yt-dlp --geo-bypass-country US "URL"

undefined

Post-Processing

后处理

Video Post-Processing

视频后处理

bash

undefined

bash

undefined

Merge video and audio to MP4

yt-dlp --merge-output-format mp4 "URL"

Re-encode to H.264

yt-dlp --recode-video mp4 "URL"

Add metadata

yt-dlp --add-metadata "URL"

Embed thumbnail

yt-dlp --embed-thumbnail "URL"

undefined

yt-dlp --embed-thumbnail "URL"

undefined

Audio Post-Processing

音频后处理

bash

undefined

bash

undefined

Extract audio and convert to MP3

yt-dlp -x --audio-format mp3 --audio-quality 0 "URL"

Add metadata to audio file

yt-dlp -x --audio-format mp3 --add-metadata "URL"

undefined

yt-dlp -x --audio-format mp3 --add-metadata "URL"

undefined

Common Use Cases

常见使用场景

1. Download Music from YouTube

1. 从 YouTube 下载音乐

bash

yt-dlp -x --audio-format mp3 --audio-quality 0 \
  -o "%(artist)s - %(title)s.%(ext)s" \
  --add-metadata \
  --embed-thumbnail \
  "MUSIC_VIDEO_URL"

bash

yt-dlp -x --audio-format mp3 --audio-quality 0 \
  -o "%(artist)s - %(title)s.%(ext)s" \
  --add-metadata \
  --embed-thumbnail \
  "MUSIC_VIDEO_URL"

2. Download Educational Course

2. 下载教育课程

bash

yt-dlp -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" \
  --write-subs --embed-subs \
  --write-info-json \
  "COURSE_PLAYLIST_URL"

bash

yt-dlp -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" \
  --write-subs --embed-subs \
  --write-info-json \
  "COURSE_PLAYLIST_URL"

3. Archive Channel (New Videos Only)

3. 归档频道（仅新视频）

bash

yt-dlp --download-archive downloaded.txt \
  -o "%(uploader)s/%(upload_date)s - %(title)s.%(ext)s" \
  -f "bestvideo[height<=1080]+bestaudio/best" \
  "https://www.youtube.com/@ChannelName/videos"

bash

yt-dlp --download-archive downloaded.txt \
  -o "%(uploader)s/%(upload_date)s - %(title)s.%(ext)s" \
  -f "bestvideo[height<=1080]+bestaudio/best" \
  "https://www.youtube.com/@ChannelName/videos"

4. Download Podcast as Audio

4. 将播客下载为音频

bash

yt-dlp -x --audio-format mp3 --audio-quality 0 \
  -o "%(playlist)s/%(playlist_index)s. %(title)s.%(ext)s" \
  --add-metadata \
  "PODCAST_PLAYLIST_URL"

bash

yt-dlp -x --audio-format mp3 --audio-quality 0 \
  -o "%(playlist)s/%(playlist_index)s. %(title)s.%(ext)s" \
  --add-metadata \
  "PODCAST_PLAYLIST_URL"

5. Download Conference Talks

5. 下载会议演讲

bash

yt-dlp -f "bestvideo[height<=720]+bestaudio" \
  -o "Conference/%(title)s.%(ext)s" \
  --write-subs --embed-subs --sub-langs en \
  "CONFERENCE_PLAYLIST_URL"

bash

yt-dlp -f "bestvideo[height<=720]+bestaudio" \
  -o "Conference/%(title)s.%(ext)s" \
  --write-subs --embed-subs --sub-langs en \
  "CONFERENCE_PLAYLIST_URL"

6. Batch Download from Multiple Sites

6. 从多个网站批量下载

bash

undefined

bash

undefined

Create urls.txt with mixed URLs (YouTube, Vimeo, etc.)

yt-dlp -a urls.txt
-f "bestvideo+bestaudio/best"
-o "%(extractor)s/%(uploader)s/%(title)s.%(ext)s"

undefined

yt-dlp -a urls.txt
-f "bestvideo+bestaudio/best"
-o "%(extractor)s/%(uploader)s/%(title)s.%(ext)s"

undefined

Configuration File

配置文件

Create

~/.config/yt-dlp/config

for default options:

undefined

创建

~/.config/yt-dlp/config

以设置默认选项：

undefined

Default format

-f bestvideo[height<=1080]+bestaudio/best

Output template

-o ~/Downloads/%(uploader)s/%(title)s.%(ext)s

Embed metadata

--add-metadata --embed-thumbnail

Write subtitles

--write-subs --sub-langs en

Continue on errors

--ignore-errors

Rate limit

--limit-rate 5M

undefined

--limit-rate 5M

undefined

Troubleshooting

故障排除

Video Unavailable

视频不可用

bash

undefined

bash

undefined

Try with cookies from browser

yt-dlp --cookies-from-browser chrome "URL"

Update yt-dlp

pip install -U yt-dlp

undefined

pip install -U yt-dlp

undefined

Age-Restricted Content

受年龄限制的内容

bash

undefined

bash

undefined

Use browser cookies

yt-dlp --cookies-from-browser firefox "URL"

Or login with credentials

yt-dlp --username YOUR_USERNAME --password YOUR_PASSWORD "URL"

undefined

yt-dlp --username YOUR_USERNAME --password YOUR_PASSWORD "URL"

undefined

Format Not Available

格式不可用

bash

undefined

bash

undefined

List all formats first

yt-dlp -F "URL"

Then select specific format

yt-dlp -f FORMAT_ID "URL"

undefined

yt-dlp -f FORMAT_ID "URL"

undefined

Slow Downloads

下载缓慢

bash

undefined

bash

undefined

Use multiple connections

yt-dlp --concurrent-fragments 4 "URL"

Or use external downloader

yt-dlp --external-downloader aria2c "URL"

undefined

yt-dlp --external-downloader aria2c "URL"

undefined

Integration with Other Tools

与其他工具集成

FFmpeg Integration

FFmpeg 集成

yt-dlp automatically uses ffmpeg when installed for:

Merging video and audio streams
Converting formats
Embedding thumbnails and metadata
Post-processing

安装 ffmpeg 后，yt-dlp 会自动使用 ffmpeg 来完成：

合并视频和音频流
转换格式
嵌入缩略图和元数据
执行后处理

Aria2c for Faster Downloads

使用 Aria2c 加快下载速度

bash

yt-dlp --external-downloader aria2c \
  --external-downloader-args "-x 16 -s 16 -k 1M" \
  "URL"

bash

yt-dlp --external-downloader aria2c \
  --external-downloader-args "-x 16 -s 16 -k 1M" \
  "URL"

Legal and Ethical Considerations

法律与道德考量

⚠️ Important:

Only download content you have rights to
Respect copyright and Terms of Service
Don't distribute copyrighted content
YouTube's ToS prohibits downloading most content
Use for personal archival and educational purposes
Many creators offer official download options
Consider supporting creators through official channels

⚠️ 重要：

仅下载你有权获取的内容
遵守版权规定和服务条款
不要分发受版权保护的内容
YouTube 的服务条款禁止下载大多数内容
用于个人归档和教育目的
许多创作者提供官方下载选项
考虑通过官方渠道支持创作者

Performance Tips

性能提示

Use Archive Files: Track downloads to avoid re-downloading
Limit Rate: Prevent network congestion with
```
--limit-rate
```
Concurrent Fragments: Speed up with
```
--concurrent-fragments 4
```
Choose Format Wisely: Lower quality = faster download
Use External Downloader: aria2c can be faster than built-in
Batch Smartly: Process in chunks, not all at once

使用归档文件：跟踪下载内容，避免重复下载
限制速率：使用
```
--limit-rate
```
防止网络拥塞
并发分片：使用
```
--concurrent-fragments 4
```
加快下载
明智选择格式：画质越低，下载越快
使用外部下载器：aria2c 可能比内置下载器更快
智能批量处理：分批处理，而不是一次处理全部

Updates

更新

Keep yt-dlp updated for best compatibility:

bash

undefined

保持 yt-dlp 更新以获得最佳兼容性：

bash

undefined

Update via pip

pip install -U yt-dlp

Check version

yt-dlp --version

undefined

yt-dlp --version

undefined

Resources

资源

yt-dlp GitHub: https://github.com/yt-dlp/yt-dlp
Supported Sites: https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md
Format Selection: https://github.com/yt-dlp/yt-dlp#format-selection

Version: 1.0.0 Last Updated: 2025-11-07 Maintained by: Claude Code Skills Collection

yt-dlp GitHub：https://github.com/yt-dlp/yt-dlp
支持的网站：https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md
格式选择：https://github.com/yt-dlp/yt-dlp#format-selection

版本：1.0.0 最后更新：2025-11-07 维护方：Claude Code Skills Collection

youtube-downloader

Original

Translation

YouTube & Video Downloader Skill

YouTube 与视频下载 Skill

When to Use This Skill

何时使用此 Skill

Supported Websites (1000+)

支持的网站（1000 多个）

Video Platforms

视频平台

Educational

教育平台

News & Media

新闻与媒体

And 1000+ more...

以及其他 1000 多个网站……

Installation

安装

Install yt-dlp (if not already installed)

Install yt-dlp (if not already installed)

Install ffmpeg (required for format conversion)

Install ffmpeg (required for format conversion)

Ubuntu/Debian:

Ubuntu/Debian:

macOS:

macOS:

Verify installation

Verify installation

Basic Usage

基本用法

Download Best Quality Video

下载最佳画质视频

Download Best Quality Audio (as M4A)

下载最佳音质音频（M4A 格式）

Download and Convert to MP3

下载并转换为 MP3

Download Specific Quality

下载指定画质

1080p video with best audio

1080p video with best audio

4K video

4K video

720p video

720p video

Advanced Features

高级功能

Download Entire Playlist

下载整个播放列表

Download Playlist Range

下载播放列表范围

Videos 1-10

Videos 1-10

Videos from #5 onwards

Videos from #5 onwards

Download All Videos from Channel

下载频道中的所有视频

Download with Subtitles

下载字幕

Download all available subtitles

Download all available subtitles

Download and embed subtitles

Download and embed subtitles

Download only subtitles (no video)

Download only subtitles (no video)

Custom Naming and Organization

自定义命名和整理

Custom filename template

Custom filename template

By date uploaded

By date uploaded

With video ID

With video ID

Download Thumbnails

下载缩略图

Download and embed thumbnail

Download and embed thumbnail

Download thumbnail only

Download thumbnail only

Download Metadata