video-watcher

# Video Watcher

Fetch transcripts from **YouTube** and **Bilibili** videos to enable summarization, QA, and content extraction.

## Supported Platforms

- ✅ **YouTube** (youtube.com, youtu.be)
- ✅ **Bilibili** (bilibili.com, b23.tv)

## Usage

### Get Transcript (Auto-detect Platform)

```bash
python3 {baseDir}/scripts/get_transcript.py "VIDEO_URL"
```

### Specify Language

```bash
python3 {baseDir}/scripts/get_transcript.py "VIDEO_URL" --lang zh-CN
```

## Examples

### YouTube Video
```bash
python3 {baseDir}/scripts/get_transcript.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
```

### Bilibili Video
```bash
python3 {baseDir}/scripts/get_transcript.py "https://www.bilibili.com/video/BV1xx411c7mD"
```

### With Custom Language
```bash
# Get English subtitles for a Bilibili video
python3 {baseDir}/scripts/get_transcript.py "https://bilibili.com/video/..." --lang en

# Get Chinese subtitles for a YouTube video
python3 {baseDir}/scripts/get_transcript.py "https://youtube.com/watch?v=..." --lang zh-CN
```

## Default Languages

| Platform | Default Language |
|----------|-----------------|
| YouTube  | `en` (English)  |
| Bilibili | `zh-CN` (Chinese) |

## Common Language Codes

- `en` - English
- `zh-CN` - Simplified Chinese (简体中文)
- `zh-TW` - Traditional Chinese (繁體中文)
- `ja` - Japanese
- `ko` - Korean
- `es` - Spanish
- `fr` - French
- `de` - German

## Notes

- Requires `yt-dlp` to be installed and available in PATH
- Works with videos that have closed captions (CC) or auto-generated subtitles
- Automatically detects platform from URL
- If no subtitles available, the script will fail with an error message
- yt-dlp natively supports both YouTube and Bilibili

# Video Watcher

Universal transcript fetcher for **YouTube** and **Bilibili** videos.

## Features

- ✅ **YouTube Support** - youtube.com, youtu.be
- ✅ **Bilibili Support** - bilibili.com, b23.tv
- ✅ **Auto Platform Detection** - Automatically identifies video platform from URL
- ✅ **Smart Language Defaults** - zh-CN for Bilibili, en for YouTube
- ✅ **Custom Language** - Override with `--lang` flag
- ✅ **Dual Format** - Supports both VTT and SRT subtitle formats

## Installation

### Prerequisites

Install [yt-dlp](https://github.com/yt-dlp/yt-dlp):

```bash
# macOS
brew install yt-dlp

# Linux
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod +x /usr/local/bin/yt-dlp

# Python
pip install yt-dlp
```

### Install via ClawHub

```bash
clawhub install video-watcher
```

### Manual Installation

1. Download this skill folder
2. Place it in your OpenClaw workspace: `~/.openclaw/workspace/skills/video-watcher/`

## Usage

### Basic Usage (Auto-detect)

```bash
# YouTube
python3 ~/.openclaw/workspace/skills/video-watcher/scripts/get_transcript.py \
  "https://www.youtube.com/watch?v=VIDEO_ID"

# Bilibili
python3 ~/.openclaw/workspace/skills/video-watcher/scripts/get_transcript.py \
  "https://www.bilibili.com/video/BVxxxxx"
```

### Specify Language

```bash
# Get English subtitles for a Bilibili video
python3 scripts/get_transcript.py "https://bilibili.com/video/..." --lang en

# Get Chinese subtitles for a YouTube video
python3 scripts/get_transcript.py "https://youtube.com/watch?v=..." --lang zh-CN
```

## Default Languages

| Platform | Default | Common Alternatives |
|----------|---------|-------------------|
| YouTube  | `en`    | `zh-CN`, `ja`, `es`, `fr` |
| Bilibili | `zh-CN` | `en`, `zh-TW`, `ja` |

## Output Format

```markdown
# Platform: Bilibili
# Language: zh-CN
# URL: https://www.bilibili.com/video/...

[Clean transcript text without timestamps...]
```

## Troubleshooting

### "yt-dlp n...