youtube-downloader

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

YouTube Video Downloader

YouTube视频下载器

First time? If
setup_complete: false
above, run
./SETUP.md
first, then set
setup_complete: true
.

Download YouTube videos with quality control, optimized for sharing on WhatsApp and other platforms.

首次使用？ 如果上方显示
setup_complete: false
，请先运行
./SETUP.md
，然后将
setup_complete: true
。

可控制画质下载YouTube视频，针对在WhatsApp等平台分享进行优化。

Requirements

要求

This skill requires Python to be installed on your system.

Python 3.9+ (required)
yt-dlp (
```
pip install yt-dlp
```
)
ffmpeg (for audio extraction)

First time setup? Read SETUP.md for detailed installation instructions for Windows, macOS, and Linux.

本技能要求您的系统已安装Python。

Python 3.9+（必需）
yt-dlp（
```
pip install yt-dlp
```
）
ffmpeg（用于音频提取）

首次设置？ 阅读SETUP.md获取Windows、macOS和Linux系统的详细安装说明。

Quick Start

快速开始

bash

cd ~/.claude/skills/youtube-downloader/scripts

bash

cd ~/.claude/skills/youtube-downloader/scripts

Download for WhatsApp (144p, small file)

为WhatsApp下载（144p，小文件）

python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --quality whatsapp

Download standard quality (480p)

下载标准画质（480p）

python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --quality standard

Download high quality (720p)

下载高清画质（720p）

python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --quality high

Download best quality available

下载可用的最佳画质

python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --quality best

List available formats

列出可用格式

python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --list

undefined

python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --list

undefined

Quality Presets

画质预设

Preset	Resolution	Max Size	Use Case
`whatsapp`	144p	~10MB	WhatsApp sharing (default)
`standard`	480p	~50MB	General use
`high`	720p	~100MB	Good quality
`best`	Best available	Varies	Maximum quality

预设	分辨率	最大文件大小	使用场景
`whatsapp`	144p	~10MB	WhatsApp分享（默认）
`standard`	480p	~50MB	一般用途
`high`	720p	~100MB	优质画质
`best`	可用最佳画质	大小不定	最高画质

Options

选项

Option	Description
`--quality` / `-q`	Quality preset (whatsapp/standard/high/best)
`--output` / `-o`	Output directory (default: current dir)
`--list` / `-l`	List available formats without downloading
`--audio-only` / `-a`	Extract audio only (MP3)

选项	描述
`--quality` / `-q`	画质预设（whatsapp/standard/high/best）
`--output` / `-o`	输出目录（默认：当前目录）
`--list` / `-l`	列出可用格式而不下载
`--audio-only` / `-a`	仅提取音频（MP3格式）

Examples

示例

bash

undefined

bash

undefined

Download and send to WhatsApp

下载并发送至WhatsApp

python download.py "https://youtube.com/watch?v=xxx" -q whatsapp

Then use WhatsApp skill to send

然后使用WhatsApp技能发送

Download to specific folder

下载至指定文件夹

python download.py "https://youtube.com/watch?v=xxx" -o ~/Downloads

Audio only (for podcasts/music)

仅提取音频（用于播客/音乐）

python download.py "https://youtube.com/watch?v=xxx" --audio-only

undefined

python download.py "https://youtube.com/watch?v=xxx" --audio-only

undefined

WhatsApp Size Limits

WhatsApp大小限制

16MB: Direct video sharing limit
2GB: Document sharing limit (preserves quality)

For videos over 16MB, either:

Use lower quality preset
Send as document (not video)

16MB：直接视频分享限制
2GB：文档分享限制（保留画质）

对于超过16MB的视频，可选择：

使用更低画质预设
以文档形式发送（而非视频）