zhongwei/gh-dotclaude-marketplace-plugins-yt-transcribe

Files

Zhongwei Li 24daaa2002 Initial commit

2025-11-29 18:24:22 +08:00

2.7 KiB

Raw Blame History

model, allowed-tools, argument-hint, description

model	allowed-tools	argument-hint	description
claude-sonnet-4-5	Task, Bash, Read, Write	<video-url> [--format format] [--audio-only] [--quality quality]	Download a YouTube video with intelligent format selection

YouTube Download Command

Download a YouTube video using yt-dlp with support for JavaScript-protected content, flexible format selection, and optional post-processing.

Arguments

$1 (Required): video-url

The full YouTube URL to download. Example: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Optional flags:

--format - Format selection: best (default), best-video, best-audio, mp4, webm, mkv
--audio-only - Extract audio only (creates m4a/mp3 file)
--quality - Quality preference: 1080p, 720p, 480p, 360p, auto (default)
--no-js - Disable JavaScript rendering (faster for standard videos)
--output-dir - Custom output directory (default: ./downloads)
--convert-to - Convert to target format using ffmpeg (e.g., mp3, wav)

Examples

/yt-download "https://www.youtube.com/watch?v=VIDEO_ID"
/yt-download "https://www.youtube.com/watch?v=VIDEO_ID" --format best --quality 720p
/yt-download "https://www.youtube.com/watch?v=VIDEO_ID" --audio-only --convert-to mp3
/yt-download "https://www.youtube.com/watch?v=VIDEO_ID" --format webm --quality 1080p

How It Works

Video Analysis - Inspects video source and available formats
Format Selection - Recommends optimal codec/container for your use case
Download - Executes yt-dlp with JavaScript support for protected content
Post-Processing - Optionally converts format or extracts audio
Validation - Confirms successful download and file integrity

Configuration

The downloader automatically:

Enables JavaScript rendering for protected content
Sets appropriate user agents and headers
Handles throttling and rate limiting
Embeds metadata (title, description, thumbnail)
Creates output directory if needed

Output

Downloaded video file with metadata embedded
File naming: {Video Title}.{extension}
Metadata includes thumbnail, description, and upload date
Console output shows progress, speed, and estimated time remaining

Tips

Use --audio-only for podcasts, music, or when video content isn't needed
--format best auto-selects best available quality (usually 1080p60 if available)
JavaScript rendering is enabled by default but can be disabled for speed with --no-js
Conversions use ffmpeg, so ensure it's installed for audio extraction
Downloads are stored in ./downloads by default; change with --output-dir

Invoke the media-downloader agent to handle download operations and format optimization.

2.7 KiB Raw Blame History