🎬 videodown

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

When to Use

✅ USE this skill when:

Download & Search

• "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]"

Video Editing & Assets

• "Get video assets for editing"
• "Download video clips for my project"
• "Find background video footage"
• "Download tutorial video for reference"
• "Get video素材 (video assets)"
• "下载剪辑素材"
• "找视频素材"

Content Creation

• "Download video for content creation"
• "Get video for my YouTube channel"
• "Download reference video"
• "找创作素材"
• "下载参考视频"

Audio Extraction

• "Extract audio from video"
• "Convert video to MP3"
• "Get background music from video"
• "提取音频"
• "转 MP3"

Chinese Natural Language

• "下载 lol 视频"
• "找个 3 分钟的视频"
• "提取这个视频的音频"
• "搜索 B 站的教程视频"
• "下载剪辑素材"
• "找视频创作素材"

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)
videodown <url> --convert            # Convert to H.264 (QuickTime compatible)

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

History

videodown history           # View download history
videodown history --limit 20 # Show last 20 items

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/videodown)

Common Patterns