feat: more optional options

2026-06-16 13:26:47 +03:30
parent cad4e681c3
commit 302aa2e778
4 changed files with 220 additions and 66 deletions
@@ -157,8 +157,32 @@ python video-generator/scripts/combine_video_audio.py \
  --rate 190
 ```

+## Optional advanced options
+
+These options are not needed for normal usage.
+
+- `--audio-output "output/voiceover.wav"` — saves a copy of the generated voiceover WAV in one-step mode.
+- `--keep-temp` — keeps temporary voice parts for debugging. By default, temporary files are deleted.
+- `--volume 1.2` — changes voiceover volume. Default is `1.0`.
+- `--silence-padding 0.15` — adds a small pause after each caption if the SRT time slot has enough space. Default is `0.0`.
+- `--sample-rate 48000` — changes generated audio sample rate. Default is `44100`.
+- `--channels 1` — changes generated audio channels. Use `1` for mono or `2` for stereo. Default is `2`.
+- `--reencode-video` — re-encodes video with H.264 if the copied video output has compatibility issues.
+
+Example:
+
+```bash
+python video-generator/scripts/combine_video_audio.py \
+  --video "video-generator/input/your_video.mp4" \
+  --srt "video-generator/subtitles/your_subtitles.srt" \
+  --output "video-generator/output/final_video.mp4" \
+  --audio-output "video-generator/output/voiceover.wav" \
+  --volume 1.2 \
+  --silence-padding 0.15 \
+  --sample-rate 48000 \
+  --channels 2
+```
+
 ## Notes

-If a caption has too much text for its time slot, the script keeps the SRT timing and trims the speech. Fix that by increasing the subtitle duration, shortening the sentence, or increasing speed.
-
-If the final MP4 has compatibility issues, add `--reencode-video` to the combine command.
+If a caption has too much text for its time slot, the script keeps the SRT timing and trims the speech. Fix that by increasing the subtitle duration, shortening the sentence, or increasing speed.