yt-dlp
A robust CLI wrapper for yt-dlp to download videos, playlists, and audio from YouTube and thousands of other sites. Supports format selection, quality control, metadata embedding, and cookie authentication.
- License 许可
- Apache-2.0
- 所属仓库
- bravew/Neumar
- 最近更新
- 2026-11-14
- Stars
- ★ 12
- Forks
- 4
01 前言 Front Matter
- name
- yt-dlp
- description
- A robust CLI wrapper for yt-dlp to download videos, playlists, and audio from YouTube and thousands of other sites. Supports format selection, quality control, metadata embedding, and cookie authentication.
02 资源文件 4
- 参考文档_meta.json267 B
- 参考文档references/guide.md6.0 KB
- 参考文档references/usage.md6.0 KB
- 脚本scripts/download.sh1.5 KB
03 SKILL.md 正文
yt-dlp Skill
Overview
This skill provides a convenient interface to yt-dlp, a powerful command-line media downloader. It simplifies the process of downloading videos, extracting audio, and managing playlists with optimal quality settings and metadata handling.
Usage
- Role: Media Archivist.
- Trigger: "Download this video", "Get MP3 from YouTube", "Archive this channel".
- Output: Downloaded media files in the current directory or specified output path.
Dependencies
yt-dlp: The core downloader (must be installed in PATH).ffmpeg: Required for merging video+audio streams and format conversion.
Commands
scripts/download.sh
The primary entry point. It wraps yt-dlp with sensible defaults for high-quality archiving.
Syntax:
./scripts/download.sh <URL> [OPTIONS]
Defaults:
- Best video + best audio merged (
bv+ba/b) - Embeds metadata, thumbnail, and subtitles (
--embed-metadata,--embed-thumbnail,--embed-subs) - Output format:
Title [ID].mp4(%(title)s [%(id)s].%(ext)s)
Examples:
-
Download a single video (best quality):
scripts/download.sh "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -
Download a playlist:
scripts/download.sh "https://www.youtube.com/playlist?list=PL..." -
Extract Audio (MP3):
scripts/download.sh "URL" -x --audio-format mp3 -
Download specific resolution (e.g., 1080p):
scripts/download.sh "URL" -f "bv*[height<=1080]+ba/b[height<=1080]" -
Use Cookies (for age-restricted/premium content): Note: Requires browser cookies exported to a file or accessed directly.
scripts/download.sh "URL" --cookies-from-browser chrome
Installation & Security
This skill relies on yt-dlp and ffmpeg being installed on the host system.
- Official Sources Only: Install via
pip install yt-dlpor your system package manager (apt,brew). Avoid running curl scripts from untrusted sources. - Cookies: Use
--cookies-from-browserwith caution. For autonomous agents, prefer exporting acookies.txtfile manually to limit access to your active browser session.
Reference Guide
For advanced usage, see the comprehensive Usage Guide.
04 同仓库更多 Skills
weather
Get current weather and forecasts (no API key required).
video-editing
Video Mode editing guidance for agentic storyboard, timeline, caption, audio, render, and publish work through video_* MCP tools.
video-edit
Conversational video editing workflow for cuts, transcript-based edits, overlays, captions, subtitle burn-in, and render planning with ffmpeg. Use when the user asks to edit video by instruction, cut silence or words, add subtitles, add overlays, transcribe video, or render a final clip.
skill-creator
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
ship
Full shipping workflow: test, review, version, changelog, and PR creation. Use when: preparing to ship code, creating releases, merging PRs.
security-audit
Application security audit covering OWASP Top 10, STRIDE threat modeling, and secrets archaeology. Use when: security review, pre-launch audit, dependency scanning.