cshortranslate 0.1.0

OCR-based subtitle extraction from video files

cshortranslate

OCR-based subtitle extraction from video files. Designed for extracting Chinese subtitles from long drama videos.

Installation

pip install cshortranslate

For optional video backends:

pip install cshortranslate[pyav]      # PyAV backend
pip install cshortranslate[ffmpegcv]  # ffmpegcv backend
pip install cshortranslate[all]       # All backends

Usage

cshortranslate video.mp4
cshortranslate video.mp4 -o output.srt
cshortranslate video.mp4 --fps 15 --region "bottom:20"
cshortranslate video.mp4 --preview

Options

Option	Description
-o, --output	Output SRT path (default: <video>.srt)
--fps	Frame extraction rate (default: 10)
--region	Subtitle region: "bottom:15" for bottom 15%, or "x,y,w,h" in pixels
--preview	Show first frame with crop overlay for region selection
--backend	Video backend: opencv, pyav, ffmpegcv, degirum
--batch-size	Frames to OCR in parallel (default: 1)
--num-workers	OCR worker threads (default: 1)
--min-chars	Minimum characters to keep (default: 2)
--min-dur	Minimum duration in seconds (default: 0.3)

Requirements

• Python 3.9+
• rapidocr-onnxruntime
• opencv-python
• tqdm
• numpy

License

MIT