# m1guelpf/auto-subtitle

Automatically generate and overlay subtitles for any video.

Repository: https://github.com/m1guelpf/auto-subtitle
Canonical: https://ross.abutalabs.com/products/auto-subtitle
Language: Python
License: MIT
License Family: permissive
Topics: ffmpeg, openai-whisper, subtitle-generator, subtitles, subtitles-generator, whisper
Last push: 2024-07-12T08:59:25+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 1436, "days_push": 782, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2275, forks 365 (observed 2026-08-28T04:06:33.323930+00:00)

## What it is
A Python CLI tool that uses OpenAI's Whisper and ffmpeg to automatically generate subtitles for videos and burn them into the output file. It supports multiple Whisper model sizes and optional translation of subtitles into English.

## Use cases
- add subtitles to a video automatically
- burn captions into mp4 files
- transcribe video audio with whisper
- translate video subtitles to english
- generate srt-style captions for social media videos

## When to choose
- you want a simple one-command way to overlay subtitles on a video
- you need offline transcription powered by Whisper
- you want optional translation of non-English speech into English captions

## When to avoid
- you need editable subtitle files rather than burned-in captions
- you want a GUI or web interface
- you need real-time or streaming captioning

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: speech-recognition, video-processing, cli
- domain: media
- platform: windows, python, cli
- tags: whisper, ffmpeg, subtitles, transcription, burned-in-captions, video, natural-language-processing, command-line, linux, macos

## Member repositories
- m1guelpf/auto-subtitle (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:33.323930+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:41:30.895775+00:00, confidence not recorded.
  - readme: https://github.com/m1guelpf/auto-subtitle (fetched 2026-08-28T04:06:33.323930+00:00, sha e7de9f435911)
- Data as of 2026-08-30T08:39:29.467469+00:00.