一键加速视频下载
by @aiaaaa4
使用 yt-dlp 与 FFmpeg 下载、保存、检查或提取公开视频、独立音频、最佳原语言字幕及最高质量原始封面，并为后续字幕翻译准备确定性的隐藏输入。Use when Codex is asked to inspect formats, download permitted media with its bes...
clawhub install video-download📖 About This Skill
name: video-download description: Download videos from 1800+ websites and generate subtitles using Faster Whisper AI. Use when user wants to download videos from YouTube, Bilibili, Twitter, TikTok, Facebook, Vimeo, or any other supported video site, extract audio, or transcribe video content to text/subtitles. metadata: { "openclaw": { "homepage": "https://github.com/upupc/video-download", "emoji": "🎬", "requires": { "bins": ["python", "ffmpeg"], "env": [] }, "primaryEnv": "", "install": [ { "id": "pip", "kind": "pip", "packages": ["yt-dlp", "yt-dlp-ejs", "ffmpeg-python", "faster-whisper", "tqdm"], "label": "Install dependencies (pip)", } ], }, }
Video Download & Subtitle Generation
This skill downloads videos from 1800+ websites and generates subtitles using Faster Whisper AI.
Supported Websites
This skill supports downloading from virtually any video website thanks to yt-dlp. Some popular ones include:
Video Platforms:
Chinese Platforms:
International:
For the complete list of 1800+ supported sites, see: yt-dlp supported extractors Local document about supported sites: references/supportedsites.md
Important: If you see an error like Sign in to confirm you’re not a bot, you should use the cookiefile parameter for authenticated downloads. See the cookiefile usage section at the end of this document.
Prerequisites
Ensure the following Python packages are installed:
yt-dlp - For downloading videos from any supported siteyt-dlp-ejs - External JavaScript for yt-dlp supporting many runtimesffmpeg-python - For audio extractionfaster-whisper - For speech-to-text transcription (faster and more memory-efficient than openai-whisper). Note: The first run will download models from HuggingFace (default: small, ~3GB). A VPN is required for mainland China users.tqdm - For progress bar display during transcriptionInstall via pip:
pip install yt-dlp yt-dlp-ejs ffmpeg-python faster-whisper tqdm
ffmpeg must also be installed on your system
Usage
Command Line
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads"}'
Parameters
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| urls | array | Yes | List of video URLs from any supported website |
| output | string | No | Output directory (default: "./downloads") |
| model | string | No | Faster Whisper model size: tiny, base, small, medium, large, large-v2, large-v3, turbo (default: "small") |
| transcribe | boolean | No | Whether to transcribe video to subtitle (default: true) |
| subtitle_format | string | No | Subtitle format: txt, srt, vtt, json (default: "txt") |
| download_subtitle | boolean | No | Download video's built-in subtitles if available (default: false) |
| onlysubtitle | boolean | No | Only download subtitles. When true, the script uses skip_download + writesubtitles + writeautomaticsub internally (default: false) |
| overwrite_subtitle | boolean | No | Overwrite existing subtitle files (default: true, set to false to skip if exists) |
| cookie | string | No | Cookie header string; injected into http_headers.Cookie (default: "") |
| cookiesfrombrowser | string | No | Read cookies from browser (default: ""; injected only when non-empty) |
| cookiefile | string | No | Netscape-format cookie file path (default: ""; injected only when non-empty) |
Output
The skill will: 1. Create a folder for each video (named after the video title) 2. Download the video file to that folder 3. Extract audio as WAV file 4. Generate transcript using Faster Whisper 5. Save subtitle as .txt file
Output structure:
downloads/
└── Video Title/
├── Video Title.mp4
├── Video Title.wav
└── Video Title.txt
Examples
Download YouTube video:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"output":"./my_videos"}'
Download Bilibili video:
python scripts/video_parser.py '{"urls":["https://www.bilibili.com/video/BV1xx411c7XD"],"output":"./downloads"}'
Download TikTok video:
python scripts/video_parser.py '{"urls":["https://www.tiktok.com/@username/video/1234567890"],"output":"./tiktok"}'
Download multiple videos from different sites:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO1","https://www.bilibili.com/video/BV1xx","https://twitter.com/user/status/123"],"output":"./videos"}'
Download Twitch clip:
python scripts/video_parser.py '{"urls":["https://www.twitch.tv//channel/clip/ClipName"],"output":"./clips"}'
Download only (without transcription):
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","transcribe":false}'
Generate SRT subtitle:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","subtitle_format":"srt"}'
Generate VTT subtitle:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","subtitle_format":"vtt"}'
Download video with built-in subtitles:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","download_subtitle":true}'
Download with custom Faster Whisper model:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","model":"large"}'
Skip transcription if subtitle already exists:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","overwrite_subtitle":false}'
Download video with Cookie:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookie":"sid=xxx; token=yyy"}'
Download video with cookies from browser:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookiesfrombrowser":"chrome"}'
Download video with cookie file:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookiefile":"/path/to/cookies.txt"}'
Only download subtitles:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","onlysubtitle":true,"cookiefile":"/path/to/cookies.txt"}'
cookiefile usage:
cookies.txt to your local machine.cookiefile to that local file path, for example:python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookiefile":"/Users/yourname/Downloads/cookies.txt"}'
Troubleshooting
brew install ffmpeg (macOS) or your system's package manager💡 Examples
Download YouTube video:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"output":"./my_videos"}'
Download Bilibili video:
python scripts/video_parser.py '{"urls":["https://www.bilibili.com/video/BV1xx411c7XD"],"output":"./downloads"}'
Download TikTok video:
python scripts/video_parser.py '{"urls":["https://www.tiktok.com/@username/video/1234567890"],"output":"./tiktok"}'
Download multiple videos from different sites:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO1","https://www.bilibili.com/video/BV1xx","https://twitter.com/user/status/123"],"output":"./videos"}'
Download Twitch clip:
python scripts/video_parser.py '{"urls":["https://www.twitch.tv//channel/clip/ClipName"],"output":"./clips"}'
Download only (without transcription):
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","transcribe":false}'
Generate SRT subtitle:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","subtitle_format":"srt"}'
Generate VTT subtitle:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","subtitle_format":"vtt"}'
Download video with built-in subtitles:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","download_subtitle":true}'
Download with custom Faster Whisper model:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","model":"large"}'
Skip transcription if subtitle already exists:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","overwrite_subtitle":false}'
Download video with Cookie:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookie":"sid=xxx; token=yyy"}'
Download video with cookies from browser:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookiesfrombrowser":"chrome"}'
Download video with cookie file:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookiefile":"/path/to/cookies.txt"}'
Only download subtitles:
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","onlysubtitle":true,"cookiefile":"/path/to/cookies.txt"}'
cookiefile usage:
cookies.txt to your local machine.cookiefile to that local file path, for example:python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookiefile":"/Users/yourname/Downloads/cookies.txt"}'
⚙️ Configuration
Ensure the following Python packages are installed:
yt-dlp - For downloading videos from any supported siteyt-dlp-ejs - External JavaScript for yt-dlp supporting many runtimesffmpeg-python - For audio extractionfaster-whisper - For speech-to-text transcription (faster and more memory-efficient than openai-whisper). Note: The first run will download models from HuggingFace (default: small, ~3GB). A VPN is required for mainland China users.tqdm - For progress bar display during transcriptionInstall via pip:
pip install yt-dlp yt-dlp-ejs ffmpeg-python faster-whisper tqdm
ffmpeg must also be installed on your system
📋 Tips & Best Practices
brew install ffmpeg (macOS) or your system's package manager