Metadata-Version: 2.4
Name: subpilot
Version: 0.1.0
Summary: Automatically sync subtitles to video audio using faster-whisper STT
License-Expression: MIT
Keywords: ass,srt,stt,subtitle,sync,vtt,whisper
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.9
Requires-Dist: faster-whisper>=1.0.0
Requires-Dist: pysubs2>=1.6.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# SubPilot

Automatically sync subtitles to video audio using faster-whisper STT.

## Installation

```bash
pip install subpilot
```

## Usage

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

```bash
# 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)
