下载器
- 作者仓库星标 183
- 作者仓库 yt-dlp-downloader-skill
- 领域
- 数据
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @MapleShaw · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# yt-dlp Video Downloader
Download videos from thousands of websites using yt-dlp.
## Prerequisites
Before downloading, verify dependencies are installed:
```bash
# Check yt-dlp
which yt-dlp || echo "yt-dlp not installed. Install with: pip install yt-dlp"
# Check ffmpeg (required for audio extraction and format merging)
which ffmpeg || echo "ffmpeg not installed. Install with: brew install ffmpeg"
```
If not installed, install them first:
```bash
pip install yt-dlp
brew install ffmpeg # macOS
```
## Quick Start
### Basic Download (Best Quality)
```bash
yt-dlp -P "~/Downloads/yt-dlp" "VIDEO_URL"
```
### YouTube Download (Recommended - with cookies)
YouTube often blocks direct downloads with 403 errors. Always use browser cookies for YouTube:
```bash
yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "YOUTUBE_URL"
```
Supported browsers: `chrome`, `firefox`, `safari`, `edge`, `brave`, `opera`
### Download with Custom Output Path
```bash
yt-dlp -P "/path/to/save" -o "%(title)s.%(ext)s" "VIDEO_URL"
```
## Common Tasks
### 1. Download Video (Default - Best Quality)
```bash
yt-dlp -P "~/Downloads/yt-dlp" "VIDEO_URL"
```
### 2. Extract Audio Only (MP3)
```bash
yt-dlp -P "~/Downloads/yt-dlp" -x --audio-format mp3 "VIDEO_URL"
```
### 3. Download with Subtitles
```bash
yt-dlp -P "~/Downloads/yt-dlp" --write-subs --sub-langs all "VIDEO_URL"
```
### 4. Download Specific Quality
**720p:**
```bash
yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" "VIDEO_URL"
```
**1080p:**
```bash
yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" "VIDEO_URL"
```
**Best available:**
```bash
yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo+bestaudio/best" "VIDEO_URL"
```
### 5. List Available Formats (Before Download)
```bash
yt-dlp -F "VIDEO_URL"
```
Then download specific format by ID:
```bash
yt-dlp -P "~/Downloads/yt-dlp" -f FORMAT_ID "VIDEO_URL"
```
### 6. Download Playlist
```bash
# Download entire playlist
yt-dlp -P "~/Downloads/yt-dlp" -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "PLAYLIST_URL"
# Download specific range (e.g., items 1-5)
yt-dlp -P "~/Downloads/yt-dlp" -I 1:5 "PLAYLIST_URL"
```
### 7. Download with Thumbnail
```bash
yt-dlp -P "~/Downloads/yt-dlp" --write-thumbnail "VIDEO_URL"
```
## Workflow
When user provides a video URL:
1. **Identify the platform**:
- YouTube/YouTube Music → **Always use `--cookies-from-browser chrome`**
- Other sites → Try without cookies first
2. **Ask what they want** (if not specified):
- Just download the video?
- Extract audio only?
- Need subtitles?
- Specific quality?
3. **Construct the command** based on requirements
4. **Execute the download** using Shell tool with `required_permissions: ["all", "network"]`
5. **Handle errors**:
- 403 Forbidden → Retry with `--cookies-from-browser`
- Connection issues → yt-dlp auto-resumes, just retry
- Format unavailable → Use `-F` to list formats, then select
6. **Report the result** - file location and any errors
## Example Interaction
User: "帮我下载这个视频 https://www.youtube.com/watch?v=xxx"
Response:
```bash
# YouTube - use cookies to avoid 403 errors
yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "https://www.youtube.com/watch?v=xxx"
```
User: "下载这个视频的音频 https://www.bilibili.com/video/xxx"
Response:
```bash
# Bilibili - extracting audio as MP3
yt-dlp -P "~/Downloads/yt-dlp" -x --audio-format mp3 "https://www.bilibili.com/video/xxx"
```
User: "下载这个 Twitter 视频 https://twitter.com/xxx/status/123"
Response:
```bash
# Twitter/X - direct download usually works
yt-dlp -P "~/Downloads/yt-dlp" "https://twitter.com/xxx/status/123"
```
## Supported Sites
yt-dlp supports thousands of sites including:
- YouTube, YouTube Music
- Bilibili (B站)
- Twitter/X
- TikTok, Douyin (抖音)
- Vimeo
- Twitch
- And many more...
Full list: https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md
## Troubleshooting
### Common Errors and Solutions
| Error | Cause | Solution |
|-------|-------|----------|
| HTTP 403 Forbidden | YouTube blocks unauthenticated requests | Use `--cookies-from-browser chrome` |
| Video unavailable | Geo-restricted or private | Use cookies or VPN |
| Download interrupted | Network issues | Retry - yt-dlp auto-resumes |
| Format not available | Requested format doesn't exist | Use `-F` to list formats |
### Error: "yt-dlp: command not found"
```bash
pip install yt-dlp
```
### Error: "ffmpeg not found" (for audio extraction)
```bash
brew install ffmpeg # macOS
```
### Error: HTTP 403 Forbidden (YouTube)
This is the most common YouTube error. **Always use cookies for YouTube:**
```bash
# Recommended approach for YouTube
yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "YOUTUBE_URL"
```
Supported browsers: `chrome`, `firefox`, `safari`, `edge`, `brave`, `opera`
### Error: Video unavailable or geo-restricted
```bash
# Try with cookies from browser
yt-dlp --cookies-from-browser chrome "VIDEO_URL"
# Or use a specific format
yt-dlp -F "VIDEO_URL" # List formats first
yt-dlp -f FORMAT_ID "VIDEO_URL"
```
### Error: Download keeps failing
```bash
# Update yt-dlp to latest version
pip install -U yt-dlp
# Force IPv4 (sometimes helps with connection issues)
yt-dlp -4 "VIDEO_URL"
```
### Best Practices
1. **YouTube downloads**: Always use `--cookies-from-browser chrome`
2. **Large files**: yt-dlp auto-resumes, just retry if interrupted
3. **Keep yt-dlp updated**: `pip install -U yt-dlp`
4. **Check formats first**: Use `-F` before downloading if unsure
章节与文件索引
按说明文件中的顺序排列。
先决条件
YouTube 下载(推荐 - 带 cookie)
4. 下载具体质量
5. 列出可用格式(下载前)
工作流程
文件/命令 -> chrome · firefox · safari · edge · brave · opera · --cookies-from-browser chrome · required_permissions: ["all", "network"]
内容校验值 -> 00f9b7186d9a
当前原文的自动摘译,尚未人工审校。
先决条件
下载之前,验证依赖项是否已安装:如果未安装,请先安装它们:
YouTube 下载(推荐 - 带 cookie)
YouTube 经常因 403 错误而阻止直接下载。始终使用 YouTube 浏览器 cookie:支持的浏览器:
chrome、firefox、safari、edge、brave、opera4. 下载具体质量
720p: 1080p: 最佳可用:
5. 列出可用格式(下载前)
然后根据ID下载具体格式:
工作流程
当用户提供视频 URL 时: 识别平台:YouTube/YouTube Music → 始终使用
--cookies-from-browser chrome其他网站 → 首先尝试不使用 cookie 询问他们想要什么(如果未指定):