feat: initial commit

README.md

@@ -0,0 +1,27 @@
+# video2srt
+
+Generate an English `.srt` next to each video using [stable-ts](https://github.com/jianfch/stable-ts), with Demucs vocal isolation to fight hallucinations on noisy or musical audio.
+
+## Install
+
+Requires Python 3.11 and `make`.
+
+```sh
+make              # AMD ROCm (default)
+make BACKEND=cuda # NVIDIA CUDA
+make BACKEND=cpu  # CPU-only
+
+make install      # install .venv/bin/video2srt to ~/.local/bin
+make clean        # remove .venv
+```
+
+## Usage
+
+```sh
+video2srt movie.mkv                    # translate to English (default)
+video2srt -t movie.mkv                 # transcribe in source language
+video2srt -l ja movie.mkv              # force Japanese source language
+video2srt --no-denoise movie.mkv       # skip Demucs vocal isolation
+video2srt -o english.srt movie.mkv     # custom output path
+video2srt -f *.mkv                     # batch overwrite
+```