vid-tools

A collection of CLI tools for video and image editing.

Tools

video_looper.py — True Video Looper

Creates seamlessly looping videos using cross-fade blending — the tail of the video is blended directly into the head so there's no visible seam when it loops. Outputs both a simple (frame duplication) and interpolated (optical flow) version for comparison.

# Scan for frames most similar to frame 0 (potential hard-cut loop points)
python video_looper.py input.mp4 --scan

# Scan for natural visual shift moments (transitions, lighting changes)
python video_looper.py input.mp4 --scan-shift

# Create a loop at 5s with 2x slowdown and 1.5s cross-fade
python video_looper.py input.mp4 --loop-second 5.0 --slowdown 2.0 --fade 1.5

# Sub-second precision (frame offset within that second)
python video_looper.py input.mp4 --loop-second 4.7 --loop-frame 2

# Use the full video with default 1s cross-fade
python video_looper.py input.mp4 --loop-second 5.0

video_slowmo_loop.py — Slow-Motion Loop Creator

Transforms short AI-generated video clips into slow-motion, seamlessly looping backgrounds with fade transitions and GPU-accelerated frame interpolation.

python video_slowmo_loop.py input.mp4 --factor 4 --fade 1.0
python video_slowmo_loop.py input.mp4 --no-interpolation   # fast, frame duplication only

gen_qr.py — QR Code Generator

Generates QR codes in multiple formats (web PNG, print PNG, SVG) from a URL.

python gen_qr.py example.com/page

remove_bg.py — Background Removal

Removes image backgrounds using AI (U2-Net via rembg).

python remove_bg.py photo.jpg
python remove_bg.py photo.jpg custom_output.png

despill_green.py — Green Spill Removal

Removes green spill/fringe from edges of transparent PNGs (compositing cleanup).

python despill_green.py keyed_image.png

clean_green.py — Green Artifact Removal

Aggressively removes remaining green artifacts from transparent PNGs.

python clean_green.py keyed_image.png

Installation

git clone <repo-url>
cd vid-tools
python -m venv .venv
source .venv/bin/activate
pip install -e .

System dependency:

brew install ffmpeg

Output

All tools write to ./output/ by default. You can override this with an explicit output path argument where supported.

License

MIT