Video To Text

Convert video URLs or local files to text transcripts.

Usage

python3 scripts/video_to_text.py <video_url_or_local_file> [options]

Arguments

| Argument | Description | Default | |----------|-------------|---------| | url | Video URL or local file path (required) | - | | -m, --model | Whisper model size | base | | -l, --language | Specify language code | Auto-detect | | -o, --output | Output file path | Print to terminal | | --keep-files | Keep downloaded audio/video files | No | | --sessdata | Bilibili SESSDATA | From config | | --bili-jct | Bilibili bili_jct | From config | | --buvid3 | Bilibili buvid3 | From config |

Model Selection

| Model | Size | Speed | Accuracy | |-------|------|-------|----------| | tiny | ~75MB | Fastest | Lowest | | base | ~150MB | Fast | Basic | | small | ~500MB | Medium | Good | | medium | ~1.5GB | Slow | Very Good | | large | ~3GB | Slowest | Best |

Examples

# Bilibili video (requires auth)
python3 scripts/video_to_text.py "https://www.bilibili.com/video/BVxxx"

# Specify Chinese language
python3 scripts/video_to_text.py "https://www.bilibili.com/video/BVxxx" -l zh

# Local file
python3 scripts/video_to_text.py "/path/to/video.mp4" -m small

# Save to file
python3 scripts/video_to_text.py "https://www.bilibili.com/video/BVxxx" -o result.txt

Supported Platforms

1. Bilibili (bilibili.com) - Requires auth
2. YouTube - via yt-dlp
3. TikTok/Douyin - via yt-dlp
4. Twitter/X - via yt-dlp
5. Any site supported by yt-dlp
6. Local files - supports mp4, wav, m4a, webm, mkv, etc.

Bilibili Auth Setup

Method 1: Config File

Edit BILIBILI_CREDENTIALS dict in the script:

BILIBILI_CREDENTIALS = {
    "sessdata": "your_sessdata",
    "bili_jct": "your_bili_jct",
    "buvid3": "your_buvid3"
}

Method 2: Command Line

python3 scripts/video_to_text.py "https://www.bilibili.com/video/BVxxx" \
    --sessdata "xxx" \
    --bili-jct "xxx" \
    --buvid3 "xxx"

How to Get Auth Info

1. Login to Bilibili web (bilibili.com)
2. Press F12 to open Developer Tools
3. Application -> Cookies -> bilibili.com
4. Copy these values:

- SESSDATA - bili_jct - buvid3

WARNING: These are your login credentials. Don't share with others!

Installation

# Install dependencies
pip3 install bilibili-api-python yt-dlp faster-whisper aiohttp requests

# Ensure ffmpeg is installed
# Ubuntu/Debian: sudo apt install ffmpeg
# CentOS: sudo yum install ffmpeg

Dependencies

1. bilibili-api-python - Bilibili API
2. yt-dlp - Video download
3. ffmpeg - Audio/video processing
4. faster-whisper - Speech transcription
5. aiohttp - Async HTTP
6. requests - HTTP requests