A local web tool for experimenting with FFmpeg video compression settings. Compare quality vs file size in real-time.
Warning
This plugin is provided as-is for personal use. The repository is public for anyone who wants to fork and adapt it. Please do not open issues for support or feature requests.
Note
This tool runs locally via Docker. No video data leaves your machine.
🎬 Interactive Scrubbing — Move your mouse over any thumbnail to instantly preview video frames
📁 Unified Import — Select individual video files or entire folders directly from your MacBook
⏱️ Persistent List — Append new videos to your session without losing previous ones
⚙️ Full control — Adjust codec, CRF, resolution, FPS, and preset settings
⚡ Quick preview — Generate 10-second samples before full compression
📊 Size analysis — Instantly see compressed file size
🔒 Privacy-First — All generated previews and full videos stay inside the container. Nothing is saved to your Mac unless you click Download.
- Run the launcher script
- Click Import to select video files or a folder from your machine
- Hover over thumbnails to scrub through the video frames
- Click the "x" icon on any video to remove it from the list
- Select a video and adjust compression settings
- Click Generate Preview to create a 10-second sample
- Click Download Optimized Video to save the result to your Mac
- Toggle Full Duration to generate the complete optimized video
videos/
└── originals/ ← (Optional) Place source video files here to auto-load
Note
For privacy and cleanliness, the tool no longer auto-saves outputs to your folders. Use the Download button in the app to save your optimized videos.
| Setting | Description |
|---|---|
| Codec | H.264 (compatible) or H.265/HEVC (better compression) |
| CRF | Quality level: 18 (high quality) → 35 (small size) |
| Preset | Encoding speed: faster = larger files, slower = better compression |
| Resolution | Output height: Original, 1080p, 720p, or 480p |
| FPS | Frame rate: Original, 60, 30, or 24 |
| Tuning | Content optimization: Film, Animation, or Standard |
# Clone the repository
git clone https://github.com/sil-so/viddy-small.git
cd viddy-small
# Make the launcher executable
chmod +x start_optimizer.sh
# Run with default videos/ folder
./start_optimizer.sh
# Or specify a custom video folder
./start_optimizer.sh /path/to/your/videosThe app opens automatically at http://localhost:5001
docker-compose down