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
The primary entry point. It wraps yt-dlp with sensible defaults for high-quality archiving.
Syntax:
bash
./scripts/download <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):
bashscripts/download "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
- •
Download a playlist:
bashscripts/download "https://www.youtube.com/playlist?list=PL..."
- •
Extract Audio (MP3):
bashscripts/download "URL" -x --audio-format mp3
- •
Download specific resolution (e.g., 1080p):
bashscripts/download "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.
bashscripts/download "URL" --cookies-from-browser chrome
Reference Guide
For advanced usage, see the comprehensive Usage Guide.