Automatically sync subtitles to video audio using faster-whisper STT
Project description
SubPilot
Automatically sync subtitles to video audio using faster-whisper STT.
Installation
pip install subpilot
Usage
subpilot video.mp4 subtitle.srt
Options
| Flag | Description |
|---|---|
-o, --output |
Output path (default: overwrite input) |
-m, --model |
Whisper model: tiny, base, small, medium, large (default: base) |
-l, --language |
Language code (e.g. ko, en, ja). Auto-detect if omitted |
--mode |
global (single offset) or segment (per-line, default) |
--min-similarity |
Minimum similarity threshold (default: 0.4) |
--no-backup |
Skip backup of original subtitle file |
--json |
Output results as JSON |
Supported formats
- SRT (.srt)
- ASS/SSA (.ass, .ssa)
- VTT (.vtt)
Examples
# Basic sync
subpilot movie.mp4 movie.srt
# Specify language and model
subpilot movie.mp4 movie.srt -l ja -m small
# Output to a different file
subpilot movie.mp4 movie.srt -o synced.srt
# Global offset mode
subpilot movie.mp4 movie.ass --mode global
Requirements
- Python 3.9+
- ffmpeg (must be installed and available in PATH)
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
subpilot-0.1.0.tar.gz
(5.7 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file subpilot-0.1.0.tar.gz.
File metadata
- Download URL: subpilot-0.1.0.tar.gz
- Upload date:
- Size: 5.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.12 {"installer":{"name":"uv","version":"0.10.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
09ac953a0a40f8fc1484fe0b552d95fd9a6fffd79a9d3e90f12581915d7d54a7
|
|
| MD5 |
b639fb1db1905cdf8c555ed8f5b58ee2
|
|
| BLAKE2b-256 |
b7a5c76ab5afbf8d02ead421d47ff267f0adf2ada92c845f8d1a1ee13c85bd9b
|
File details
Details for the file subpilot-0.1.0-py3-none-any.whl.
File metadata
- Download URL: subpilot-0.1.0-py3-none-any.whl
- Upload date:
- Size: 7.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.12 {"installer":{"name":"uv","version":"0.10.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3977e8e0f76c275b9aa5638cc68cab7ad80c18761edf1d2f74a4181be16808f4
|
|
| MD5 |
eba7a15c5ecd1b95f596f3e91a3bf520
|
|
| BLAKE2b-256 |
26db3654f3c4cd9f3a6a58c95776a379580a3a8d82b7c7c942c4bdfba2eadde3
|
