Repository navigation
v0.1.0
First release of contact-sheet, a command-line tool that turns a folder of photos into print-ready A4 contact sheets – no import into a photo-management application needed.
Features
- Formats: Canon RAW (CR2, CR3, CRW), DNG, TIFF (8/16-bit, uncompressed, LZW, Deflate) and JPEG
- Fast RAW handling: the embedded JPEG preview is used when it is large enough; otherwise the sensor data is developed with rawler
- Layout: A4 pages with 5 columns of thumbnails (
--columns 1–20), each labelled with its file name (long names are shortened in the middle); row height adapts to the tallest photo, and a new page starts when the next row does not fit - EXIF orientation is applied; photos are sorted by name
- Output:
contact01.jpg,contact02.jpg, … in acontact-sheetsubfolder, at 300 DPI by default (--dpi, 2480×3508 px) with the resolution stored in the JPEG;--qualitysets the JPEG quality --landscapepage orientation--background whitefor printing orblackfor viewing on screen--verboselists every file with its size, pixel dimensions and format- Unreadable files are skipped with a warning; sheets from a previous run are replaced
contact-sheet ~/Pictures/2026-10-17
contact-sheet --background black --columns 4 ~/Pictures/2026-10-17Downloads
| Platform | Archive |
|---|---|
| macOS (Apple silicon) | contact-sheet-v0.1.0-aarch64-apple-darwin.tar.gz |
| macOS (Intel) | contact-sheet-v0.1.0-x86_64-apple-darwin.tar.gz |
| Linux (x86_64, static – any distribution) | contact-sheet-v0.1.0-x86_64-unknown-linux-musl.tar.gz |
| Windows (x86_64) | contact-sheet-v0.1.0-x86_64-pc-windows-msvc.zip |
Each archive has a .sha256 checksum next to it. The macOS binaries are not signed; to allow them to run, remove the quarantine attribute:
xattr -d com.apple.quarantine contact-sheetFull Changelog: https://github.com/msetkowski/contact-sheet/commits/v0.1.0