subcap 0.1.0__tar.gz

subcap-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+.venv/
+__pycache__/
+*.egg-info/
+dist/

subcap-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joseph Nordqvist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

subcap-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: subcap
+Version: 0.1.0
+Summary: Burn precisely-timed captions into video using forced alignment.
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: stable-ts>=2.16
+Description-Content-Type: text/markdown
+
+# subcap
+
+Burn precisely-timed captions into video. Give it a video and a transcript — it handles alignment, styling, and encoding.
+
+Unlike speech-to-text tools that guess both *what* is said and *when*, subcap uses **forced alignment**: you provide the transcript, and it maps each word to its exact position in the audio waveform. The result is phoneme-level timing accuracy.
+
+## Install
+
+```
+pip install subcap
+```
+
+Requires [ffmpeg](https://ffmpeg.org/) with libass support.
+
+## Usage
+
+```bash
+# Align a transcript and burn captions in
+subcap video.mov transcript.txt -o output.mp4
+
+# Use an existing SRT file (skips alignment)
+subcap video.mov subtitles.srt -o output.mp4
+
+# Choose a style
+subcap video.mov transcript.txt --style outline
+
+# ProRes output for editing
+subcap video.mov transcript.txt --quality studio -o output.mov
+
+# Portrait/vertical video (auto-detected)
+subcap shorts.mp4 transcript.txt -o shorts_captioned.mp4
+```
+
+## Options
+
+```
+subcap <video> <transcript> [options]
+
+  -o, --output          Output path (default: <input>_captioned.mp4)
+  --style               modern | outline | minimal | bold (default: modern)
+  --quality             standard | high | studio (default: standard)
+  --max-lines           Max lines per subtitle (default: 2)
+  --max-chars           Max characters per line (default: auto)
+  --line-spacing        Gap between lines in px (default: auto)
+  --position            bottom | center | top (default: bottom)
+```
+
+### Styles
+
+| Preset | Look |
+|--------|------|
+| `modern` | White bold text, semi-transparent dark box |
+| `outline` | White text with black outline |
+| `minimal` | Lighter weight, subtle shadow |
+| `bold` | Large text, opaque dark box |
+
+### Quality
+
+| Preset | Codec | Use case |
+|--------|-------|----------|
+| `standard` | H.264 | Sharing, uploading |
+| `high` | H.265 | Smaller files |
+| `studio` | ProRes 422 | Editing, broadcast |
+
+## How it works
+
+1. Extracts audio from the video
+2. Runs forced alignment via [stable-ts](https://github.com/jianfch/stable-ts) to map each word to its exact position in the audio
+3. Segments words into readable subtitle chunks
+4. Generates styled ASS subtitles adapted to the video's aspect ratio
+5. Burns captions into the video via ffmpeg
+
+## Acknowledgments
+
+Built on:
+
+- **[stable-ts](https://github.com/jianfch/stable-ts)** — Stabilized Whisper timestamps and forced alignment
+- **[OpenAI Whisper](https://github.com/openai/whisper)** — Speech recognition model used as the acoustic backbone
+- **[ffmpeg](https://ffmpeg.org/)** — Video encoding and subtitle rendering via libass
+
+## License
+
+MIT

subcap-0.1.0/README.md

@@ -0,0 +1,83 @@
+# subcap
+
+Burn precisely-timed captions into video. Give it a video and a transcript — it handles alignment, styling, and encoding.
+
+Unlike speech-to-text tools that guess both *what* is said and *when*, subcap uses **forced alignment**: you provide the transcript, and it maps each word to its exact position in the audio waveform. The result is phoneme-level timing accuracy.
+
+## Install
+
+```
+pip install subcap
+```
+
+Requires [ffmpeg](https://ffmpeg.org/) with libass support.
+
+## Usage
+
+```bash
+# Align a transcript and burn captions in
+subcap video.mov transcript.txt -o output.mp4
+
+# Use an existing SRT file (skips alignment)
+subcap video.mov subtitles.srt -o output.mp4
+
+# Choose a style
+subcap video.mov transcript.txt --style outline
+
+# ProRes output for editing
+subcap video.mov transcript.txt --quality studio -o output.mov
+
+# Portrait/vertical video (auto-detected)
+subcap shorts.mp4 transcript.txt -o shorts_captioned.mp4
+```
+
+## Options
+
+```
+subcap <video> <transcript> [options]
+
+  -o, --output          Output path (default: <input>_captioned.mp4)
+  --style               modern | outline | minimal | bold (default: modern)
+  --quality             standard | high | studio (default: standard)
+  --max-lines           Max lines per subtitle (default: 2)
+  --max-chars           Max characters per line (default: auto)
+  --line-spacing        Gap between lines in px (default: auto)
+  --position            bottom | center | top (default: bottom)
+```
+
+### Styles
+
+| Preset | Look |
+|--------|------|
+| `modern` | White bold text, semi-transparent dark box |
+| `outline` | White text with black outline |
+| `minimal` | Lighter weight, subtle shadow |
+| `bold` | Large text, opaque dark box |
+
+### Quality
+
+| Preset | Codec | Use case |
+|--------|-------|----------|
+| `standard` | H.264 | Sharing, uploading |
+| `high` | H.265 | Smaller files |
+| `studio` | ProRes 422 | Editing, broadcast |
+
+## How it works
+
+1. Extracts audio from the video
+2. Runs forced alignment via [stable-ts](https://github.com/jianfch/stable-ts) to map each word to its exact position in the audio
+3. Segments words into readable subtitle chunks
+4. Generates styled ASS subtitles adapted to the video's aspect ratio
+5. Burns captions into the video via ffmpeg
+
+## Acknowledgments
+
+Built on:
+
+- **[stable-ts](https://github.com/jianfch/stable-ts)** — Stabilized Whisper timestamps and forced alignment
+- **[OpenAI Whisper](https://github.com/openai/whisper)** — Speech recognition model used as the acoustic backbone
+- **[ffmpeg](https://ffmpeg.org/)** — Video encoding and subtitle rendering via libass
+
+## License
+
+MIT