Vertical Scroll Screenshot Stitcher

Stitches PNG/JPEG/BMP screenshots captured while scrolling into one vertical panorama.

Install

python -m pip install -r requirements.txt

Run

python stitch.py "C:\path\to\your\bmp-folder"

Important options

• --crop-anchor center|top: normalization crop behavior when input sizes differ.
• --min-dy and --max-dy-ratio: plausible scroll-distance bounds (default min-dy=20 for small scroll steps).
• --max-dx: allowed horizontal drift (0 by default to lock horizontal movement).
• --scrollbar-width: right-edge exclusion strip for matching.
• --ncc-threshold and --min-sharpness: confidence thresholds.
• --dedupe-max-dy and --dedupe-similarity: collapse duplicate/near-duplicate adjacent grabs and keep the last frame in duplicate runs (tiny shifts use a slightly relaxed similarity threshold).
• --feather: overlap blending amount for uncertain seams (default 8; lower to reduce blur/ghosting).
• Sticky bottom bars are auto-detected and trimmed from intermediate frames to prevent repeated footers.

Outputs

• <input_dir>\stitched.png: final panorama (default output path).
• <input_dir>\offsets.json: pairwise (dx, dy) plus method/confidence (default offsets path).
• <input_dir>\debug\: mask, pair previews, placement preview, seam previews (default debug path).