Simple Video Downloader
Built on yt-dlp - a powerful open-source video downloader.
Prerequisites
This skill requires yt-dlp to be installed. Before proceeding:
-
Check if yt-dlp is available:
yt-dlp --version -
If not installed, let the user decide how to handle it:
- Install via:
pip install yt-dlpor download binary from yt-dlp releases - If user has no Python, they may prefer alternative approaches (browser extensions, online services, etc.)
- Install via:
Do not install yt-dlp for the user. Let them choose their preferred method.
Workflow
- Get info: Run
yt-dlp -j <URL>for metadata,yt-dlp -F <URL>for available formats - Analyze: Check resolution, duration, chapters, subtitles/danmaku availability
- Ask user: Use question tool to confirm options
- Build command: Construct and execute the download command
Common Options
| Option | Purpose |
|---|---|
-f "bestvideo+bestaudio" | Best quality video + audio merge |
--write-subs --sub-lang danmaku | Download danmaku (Bilibili) |
--write-thumbnail --embed-thumbnail | Download and embed cover |
--embed-metadata | Embed video metadata |
-x --audio-format mp3 | Extract audio as MP3 |
--cookies-from-browser chrome | Use browser cookies for premium content |
Output
Save to _Output/ directory:
-o "_Output/%(title)s [%(id)s].%(ext)s"
Tips
- Chapters: Embedded in video by default. Do NOT use
--split-chapters(creates messy leftover files) - Bilibili: 4K/1080P60 requires premium membership. Ask about danmaku preference
- Verify: Use
ffprobeto check downloaded file details
Reference
For detailed yt-dlp options, see: references/usage-guide.md