Initial version

This commit is contained in:
Dan 2026-01-16 10:11:19 +00:00
parent 24c03dc92a
commit 6f332d46aa
4 changed files with 835 additions and 6 deletions

View file

@ -22,7 +22,6 @@ A Python tool that searches video subtitles for text matches and generates GIF c
### Using pipx (Recommended)
```bash
cd /var/home/dan/Dev/Misc/VidToSub/
pipx install -e .
```
@ -66,7 +65,8 @@ video-subtitle-gif video.mp4 "search text" \
- `--output-prefix PREFIX`: Prefix for output files (default: `output`)
- `--fps FPS`: GIF framerate in frames per second (default: `10`)
- `--width WIDTH`: GIF width in pixels, height auto-calculated (default: `480`)
- `--context SECONDS`: Extra time before/after subtitle (default: `0.5`)
- `--context-before SECONDS`: Tweak the start time of the output GIF (default: `0`)
- `--context-after SECONDS`: Tweak the end time of the output GIF (default: `0`)
## Examples
@ -105,14 +105,12 @@ video-subtitle-gif video.mp4 "important quote" \
--output-prefix quote \
--fps 20 \
--width 1280 \
--context 2.0
```
This creates higher quality GIFs with:
- 20 fps (smoother animation)
- 1280px width (larger size)
- 2 seconds of context before/after the subtitle
### Using with embedded subtitles
@ -153,7 +151,6 @@ Any format supported by FFmpeg (MP4, MKV, AVI, WebM, etc.)
- Ensure subtitle file exists in the same directory as the video
- Check that embedded subtitles exist: `ffprobe -v error -select_streams s input.mp4`
- Manually specify subtitle file path (feature not yet implemented)
### "Library not installed" errors
@ -170,4 +167,3 @@ Any format supported by FFmpeg (MP4, MKV, AVI, WebM, etc.)
- Decrease `--fps` (e.g., `8` or `10`)
- Decrease `--width` (e.g., `320` or `480`)
- Reduce `--context` to shorten clips