✓ Verified 💻 Development ✓ Enhanced Data

Video Download

Download videos from 1800+ websites and generate subtitles using Faster Whisper AI.

Rating
3.8 (322 reviews)
Downloads
814 downloads
Version
1.0.0

Overview

Download videos from 1800+ websites and generate subtitles using Faster Whisper AI.

Complete Documentation

View Source →

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:

  • YouTube, YouTube Shorts
  • Bilibili (哔哩哔哩), Niconico (ニコニコ動画)
  • TikTok, Douyin (抖音)
  • Twitter/X, Facebook, Instagram
  • Vimeo, Dailymotion
  • Twitch (clips, VODs), Kick
  • Rutube, VK Video
Chinese Platforms:
  • iQiyi (爱奇艺), Youku (优酷), MangoTV (芒果TV)
  • Weibo Video, Douyu (斗鱼), Huya (虎牙)
International:
  • Netflix, Disney+, HBO Max, Amazon Prime Video
  • BBC iPlayer, ITV, Channel 4
  • ARD, ZDF, Arte
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 site
  • yt-dlp-ejs - External JavaScript for yt-dlp supporting many runtimes
  • ffmpeg-python - For audio extraction
  • faster-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 transcription
Install via pip:
bash
pip install yt-dlp yt-dlp-ejs ffmpeg-python faster-whisper tqdm

ffmpeg must also be installed on your system

Usage

Command Line

bash
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads"}'

Parameters

ParameterTypeRequiredDescription
urlsarrayYesList of video URLs from any supported website
outputstringNoOutput directory (default: "./downloads")
modelstringNoFaster Whisper model size: tiny, base, small, medium, large, large-v2, large-v3, turbo (default: "small")
transcribebooleanNoWhether to transcribe video to subtitle (default: true)
subtitle_formatstringNoSubtitle format: txt, srt, vtt, json (default: "txt")
download_subtitlebooleanNoDownload video's built-in subtitles if available (default: false)
onlysubtitlebooleanNoOnly download subtitles. When true, the script uses skip_download + writesubtitles + writeautomaticsub internally (default: false)
overwrite_subtitlebooleanNoOverwrite existing subtitle files (default: true, set to false to skip if exists)
cookiestringNoCookie header string; injected into http_headers.Cookie (default: "")
cookiesfrombrowserstringNoRead cookies from browser (default: ""; injected only when non-empty)
cookiefilestringNoNetscape-format cookie file path (default: ""; injected only when non-empty)

Output

The skill will:

  • Create a folder for each video (named after the video title)
  • Download the video file to that folder
  • Extract audio as WAV file
  • Generate transcript using Faster Whisper
  • Save subtitle as .txt file
Output structure:
text
downloads/
└── Video Title/
    ├── Video Title.mp4
    ├── Video Title.wav
    └── Video Title.txt

Examples

Download YouTube video:

bash
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"output":"./my_videos"}'

Download Bilibili video:

bash
python scripts/video_parser.py '{"urls":["https://www.bilibili.com/video/BV1xx411c7XD"],"output":"./downloads"}'

Download TikTok video:

bash
python scripts/video_parser.py '{"urls":["https://www.tiktok.com/@username/video/1234567890"],"output":"./tiktok"}'

Download multiple videos from different sites:

bash
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:

bash
python scripts/video_parser.py '{"urls":["https://www.twitch.tv//channel/clip/ClipName"],"output":"./clips"}'

Download only (without transcription):

bash
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","transcribe":false}'

Generate SRT subtitle:

bash
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","subtitle_format":"srt"}'

Generate VTT subtitle:

bash
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:

bash
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:

bash
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","model":"large"}'

Skip transcription if subtitle already exists:

bash
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","overwrite_subtitle":false}'

Download video with Cookie:

bash
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:

bash
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookiesfrombrowser":"chrome"}'

Download video with cookie file:

bash
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookiefile":"/path/to/cookies.txt"}'

Only download subtitles:

bash
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:

  • Install the Get cookies.txt LOCALLY Chrome extension first.
URL:
  • Log in to the target website, then use the extension to export cookies.txt to your local machine.
  • Set cookiefile to that local file path, for example:
bash
python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","cookiefile":"/Users/yourname/Downloads/cookies.txt"}'

Troubleshooting

  • ffmpeg not found: Install ffmpeg via brew install ffmpeg (macOS) or your system's package manager
  • Faster Whisper model download fails: Models are downloaded from HuggingFace. Mainland China users need a VPN/proxy to download models. The default small model is ~75MB.
  • Download fails: Some videos may be geo-restricted, age-gated, or unavailable. Check the video URL and try again.
  • Cookie/auth required: Some sites need authentication. You can pass cookies via yt-dlp options if needed.

Installation

Terminal bash 

openclaw install video-download
Copied!

💻Code Examples

python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads"}'

python-scriptsvideoparserpy-urlshttpswwwyoutubecomwatchvvideoidoutputdownloads.txt
## 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:

└── Video Title.txt

--video-titletxt.txt
## Examples

### Download YouTube video:

python scripts/video_parser.py '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"],"output":"./downloads","onlysubtitle":true,"cookiefile":"/path/to/cookies.txt"}'

python-scriptsvideoparserpy-urlshttpswwwyoutubecomwatchvvideoidoutputdownloadsonlysubtitletruecookiefilepathtocookiestxt.txt
`cookiefile` usage:
- Install the **Get cookies.txt LOCALLY** Chrome extension first.  
  URL: <https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc?pli=1>
- Log in to the target website, then use the extension to export `cookies.txt` to your local machine.
- Set `cookiefile` to that local file path, for example:
example.txt
downloads/
└── Video Title/
    ├── Video Title.mp4
    ├── Video Title.wav
    └── Video Title.txt

Tags

#web_and-frontend-development #web

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author upupc
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install video-download

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0