Stampla
Deterministic, verifiable naming for photo and video archives.
stampla stamps every photo and video with an identity derived
purely from the file itself — the capture time plus a slice of the
content hash:
20260703_150727_9b677b64.nef
└──────┬──────┘ └──┬───┘
capture time hash
That name is a stable, unique identifier with properties a filename usually doesn't have:
- Everything on one timeline. Sorting by name is sorting by
capture time, across every camera, phone and scanner — no rolling
counters, no
IMG_0001 (2).jpg. - Verifiable. Because the name is reproducible from the file, the whole archive can be re-checked at any time: corruption is told apart from legitimate edits, and duplicates identify themselves.
- Groups stay whole. A RAW master, its XMP/PP3 sidecars and its editor derivatives share one name and are renamed together, atomically.
Install
$ pip install stampla
Python 3.11+ and ExifTool on PATH; no other
dependencies.
Usage
| command | what it does |
|---|---|
import |
copy a memory card into the archive, named on arrival; exit 0 certifies the card is fully accounted for — safe to format |
verify |
recompute every name and report what disagrees, classified by meaning (corruption vs. expected drift vs. date mismatch) |
rename |
bring stale names in line, atomically per file group |
inject |
let a DAM (Lightroom Classic) rename the masters it manages, via a metadata token |
organize |
report-only triage for messy trees: proposals, duplicates, undatable files |
history / undo / resume |
every apply is journaled: list runs, revert them, finish interrupted ones |
Safety first: every command is a dry run unless --apply. Applies are
validated as a whole before anything is touched, journaled before the
first change, applied atomically per group, resumable after
interruption and revertable — and a file whose capture time cannot be
resolved is reported, never renamed. Nothing is ever overwritten.
See the command guide for details, output formats and the exit-code contract, and DESIGN.md for why it works this way.
Configuration
An archive is described by a TOML file; every setting has a sensible default. See six complete example setups — from a single folder of photos to a Lightroom workflow and a naming-scheme migration — and the annotated example config for every option.
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file stampla-0.4.0.tar.gz.
File metadata
- Download URL: stampla-0.4.0.tar.gz
- Upload date:
- Size: 142.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a474b3a90748c7420f910ecc3fdff85114a87b842b1f75b377c6963bc86ee571
|
|
| MD5 |
fd27b4b53de55310c87809cbd6b8e098
|
|
| BLAKE2b-256 |
a3479e8c209d608ad692a394a02fd4ffa8f7746f966be48c45aa1806ad2defd5
|
Provenance
The following attestation bundles were made for stampla-0.4.0.tar.gz:
Publisher:
release.yml on stampla/stampla
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
stampla-0.4.0.tar.gz -
Subject digest:
a474b3a90748c7420f910ecc3fdff85114a87b842b1f75b377c6963bc86ee571 - Sigstore transparency entry: 2618920526
- Sigstore integration time:
-
Permalink:
stampla/stampla@ea10413a3a403ccea9098383abca22a4328f0604 -
Branch / Tag:
refs/tags/v0.4.0 - Owner: https://github.com/stampla
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@ea10413a3a403ccea9098383abca22a4328f0604 -
Trigger Event:
push
-
Statement type:
File details
Details for the file stampla-0.4.0-py3-none-any.whl.
File metadata
- Download URL: stampla-0.4.0-py3-none-any.whl
- Upload date:
- Size: 70.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
00b590012bfacad607b279685eab6d5dddb202009ec2f5626edd1ca10ecf30d1
|
|
| MD5 |
8e4a3f861b0c9f081f413b4b777dd36c
|
|
| BLAKE2b-256 |
4e865c52aaf1e0db1ca18b092413527fbe95ed66a7ec2e4c58391cd57fcbfcb1
|
Provenance
The following attestation bundles were made for stampla-0.4.0-py3-none-any.whl:
Publisher:
release.yml on stampla/stampla
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
stampla-0.4.0-py3-none-any.whl -
Subject digest:
00b590012bfacad607b279685eab6d5dddb202009ec2f5626edd1ca10ecf30d1 - Sigstore transparency entry: 2618920534
- Sigstore integration time:
-
Permalink:
stampla/stampla@ea10413a3a403ccea9098383abca22a4328f0604 -
Branch / Tag:
refs/tags/v0.4.0 - Owner: https://github.com/stampla
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@ea10413a3a403ccea9098383abca22a4328f0604 -
Trigger Event:
push
-
Statement type:
