🎬 videodown

Download videos from YouTube and Bilibili with built-in search.

When to Use

✅ USE this skill when:

• "Download this video" + URL
• "Find a [topic] video"
• "Search for [keyword] on YouTube/Bilibili"
• "Get a 3 minute video about [topic]"
• "Download audio from [URL]"

When NOT to Use

❌ DON'T use this skill when:

• Live streaming → use streaming tools
• Private/restricted videos → may require authentication
• Bulk downloading playlists → use specialized tools
• Commercial use → respect copyright

Quick Start

Install

# From GitHub
git clone https://github.com/chenlong1314/videodown.git
cd videodown && npm install && npm link

# Install dependencies
brew install yt-dlp ffmpeg jq

Basic Usage

# Download video from URL
videodown https://youtube.com/watch?v=xxx

# Search and download
videodown search "lol highlights"

# Search with filters
videodown search "tutorial" --duration medium --platform youtube

Natural Language Examples

Users can say:

• "找个 lol 视频" → search "lol"
• "找个 3 分钟的 lol 视频下载" → search "lol" --duration short --select 1
• "下载这个" + URL → download <url>
• "找 B 站的 lol 视频" → search "lol" --platform bilibili
• "只要音频" + URL → <url> --audio-only

Command Reference

Download

videodown <url>                      # Download video
videodown <url> --quality 1080p      # Specify quality
videodown <url> --output ~/Videos/   # Custom output
videodown <url> --audio-only         # Extract audio (MP3)

Search

videodown search "keyword"                    # Search both platforms
videodown search "keyword" --platform youtube # YouTube only
videodown search "keyword" --platform bilibili # Bilibili only
videodown search "keyword" --duration short   # <4 minutes
videodown search "keyword" --select 1         # Download 1st result

Parameters

• --quality: 360p, 720p, 1080p, best (default)
• --platform: youtube, bilibili, all (default)
• --duration: short (<4m), medium (4-20m), long (>20m)
• --output: Any path (default: ./downloads)

Common Patterns

Download from URL:

videodown https://www.youtube.com/watch?v=dQw4w9WgXcQ

Find and download:

videodown search "lol highlights" --select 1

Find short videos:

videodown search "tutorial" --duration short

Extract audio:

videodown https://youtube.com/watch?v=xxx --audio-only

Notes

• Copyright: For personal use only
• Rate limits: Search <10 times/minute
• Bilibili HQ: Requires login cookie for 4K/8K
• Dependencies: yt-dlp, ffmpeg, jq (auto-check on install)

Development

git clone https://github.com/chenlong1314/videodown.git
cd videodown
npm install
npm start -- search "test"

Links

• GitHub
• Issues

Credits

• yt-dlp - Video download engine
• BBDown - Bilibili downloader