Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 25 Oct 08:48
· 16 commits to master since this release

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 a contact-sheet subfolder, at 300 DPI by default (--dpi, 2480×3508 px) with the resolution stored in the JPEG; --quality sets the JPEG quality
  • --landscape page orientation
  • --background white for printing or black for viewing on screen
  • --verbose lists 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-17

Downloads

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-sheet

Full Changelog: https://github.com/msetkowski/contact-sheet/commits/v0.1.0