Skip to content
shammer03Public

About

Darkroom-style contact sheet proofing for film photographers — mark up scans with a simulated wax grease pencil, compare frames, and print clean proof sheets. Linux (PySide6).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

51 Commits

Folders and files

Repository files navigation

ProofMark

Darkroom contact-sheet proofing with wax grease-pencil marks (Fedora, PySide6).

A roll on the contact sheet, marked up with the grease pencil

Run

sudo dnf install python3-pyside6 python3-pillow perl-Image-ExifTool
pip install --user rawpy        # optional, for RAW files (Fedora has no python3-rawpy package)
python3 proofmark.py            # python3 proofmark.py --version

If ProofMark won't start or crashes

  • Problems are recorded in ~/.config/proofmark/crash.log. Attach it to an issue on GitHub.
  • If a library is missing, ProofMark says which dnf install command fixes it.
  • After it closes unexpectedly, ProofMark asks before reopening the previous rolls (the default is No).
  • After upgrading to a new Fedora version, reinstall rawpy: pip install --user rawpy.
  • To see errors as they happen, run it from a terminal: python3 proofmark.py

Your files are never modified

ProofMark is non-destructive, like RapidRAW. For photo.jpg it writes only sidecars next to it:

  • photo.jpg.pmdata — ProofMark's grease marks, rating, film and gear (JSON)
  • photo.jpg.rrdata — RapidRAW's sidecar. ProofMark only adds Artist, Copyright and a "Film · Camera · Lens" UserComment to its exif section; RapidRAW applies them when it exports. Your RapidRAW edits, rating and tags are kept, and a field you change in RapidRAW is never overwritten.
  • photo.xmp — rating and marks for other apps (an existing .xmp from another app is left alone)
  • .proofmark-roll.json in the roll folder — roll title, shot date, lab, keywords, notes and frame order

exiftool is optional: it is only used to read RAW files' EXIF the first time a .rrdata is created.

Tests

python3 release.py test       # or: python3 -m unittest discover -s tests

The tests draw off screen and use a throw-away home folder, so they never touch your settings, photos or Desktop. Every release bump runs them first.

Release workflow

./release.py bump minor "What changed"    # version, build number, changelog, spec + AppStream
git commit -am "Release vX.Y.Z" && git tag vX.Y.Z && git push --tags
./release.py build                        # dist/: attach proofmark.py + .sha256 to the GitHub release
./release.py icon                         # redraws packaging/proofmark-512.png

Set UPDATE_REPO = "owner/repo" in proofmark.py (or Settings ▸ Updates) to enable in-app update checks.

Licence: GPL-3.0-or-later, © 2026 S. Hambrick (see LICENSE).

About

Darkroom-style contact sheet proofing for film photographers — mark up scans with a simulated wax grease pencil, compare frames, and print clean proof sheets. Linux (PySide6).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages