🎬 videodown

---

name: videodown

description: Download videos from YouTube and Bilibili with search. Use when users ask to find or download videos. Supports natural language like "find a 3 minute lol video". No API key needed.

homepage: https://github.com/chenlong1314/videodown

metadata: { "openclaw": { "emoji": "🎬", "requires": { "bins": ["yt-dlp", "ffmpeg", "jq"] } } }

---

# 🎬 videodown

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

When to Use

✅ **USE this skill when:**

Download & Search

Video Editing & Assets

Content Creation

Audio Extraction

Chinese Natural Language

When NOT to Use

❌ **DON'T use this skill when:**

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:

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

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

Development

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

Links

Interaction Strategy

Error Handling (Phase 1)

The skill implements 7 error types with user-friendly messages and quick recovery options:

| Error Type | Code | User Message | Quick Actions |

|-----------|------|--------------|---------------|

| Download Failed | `ERR_DOWNLOAD` | Video temporarily unavailable | Retry, Search Similar |

| No Search Results | `ERR_SEARCH` | No videos found for keyword | Retry with different keyword |

| Network Error | `ERR_NETWORK` | Connection interrupted | Retry (supports resume) |

| Copyright Restricted | `ERR_COPYRIGHT` | Copyright protected content | Search Similar |

| Invalid URL | `ERR_INVALID_URL` | URL not recognized | Re-enter URL |

| Unsupported Format | `ERR_FORMAT` | Format not supported | Choose MP4/MP3 |

| Storage Full | `ERR_STORAGE` | Insufficient storage | Lower quality, Audio only |

Each error provides:

Confirmation Mechanism (Phase 2)

Automatic confirmation prompts for:

1. **Large Files (>500MB)**: Explicit size warning with estimated time

2. **Batch Downloads (>5 items)**: List all items with total size

3. **Audio Extraction**: Format confirmation (MP3 320kbps)

Confirmation messages include:

Progress Display (Phase 3)

Quick Commands (Phase 4)

Available commands in interactive mode:

| Command | Description | Example |

|---------|-------------|---------|

| `/search <keyword>` | Search videos | `/search lol` |

| `/download <URL>` | Download video | `/download https://...` |

| `/audio <URL>` | Extract audio | `/audio https://...` |

| `/history` | View history | `/history` |

| `/cancel` | Cancel current task | `/cancel` |

| `/help` | Show help | `/help` |

Credits