From 3a3ae4a4424136ad4a5be636c06fe036711558a2 Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Sat, 18 Jul 2026 16:22:22 +0300 Subject: Add CHRONOLOGICAL_ORDER config option to order albums by EXIF date taken Adds a new yes/no config setting (default no, preserving current behavior) that orders the main album's photos by EXIF date taken (ascending) instead of the default filename/shuffle order. Reuses the existing EXIF cache and tag fallback chain (DateTimeOriginal -> DateTimeDigitized -> DateTime) already used for tooltips/details/stats, so ordering never disagrees with what those features show. Photos with no usable EXIF date fall back to their source file's mtime, staying fully deterministic and crash-free. CHRONOLOGICAL_ORDER takes precedence over SHUFFLE when both are enabled, documented in album-photo-select.source.sh and docs/configuration.md. Wired through the config registry (CONFIG_SPECS), validation, CLI flags (--chronological/--no-chronological), --print-config, --dry-run, --verbose logging, and shuriken.json generation metadata. Adds unit and end-to-end tests covering default-off behavior, EXIF-date ordering with shuffle precedence, and mtime fallback for EXIF-less photos. Co-Authored-By: Claude Sonnet 5 --- docs/usage.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs/usage.md') diff --git a/docs/usage.md b/docs/usage.md index 9436e36..5cb35b5 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -72,6 +72,8 @@ config variable documented in [configuration.md](configuration.md). | `--feature PERCENT` | `THUMB_FEATURE_PERCENT` | | `--image-jobs N` | `IMAGE_JOBS` | | `--random-seed VALUE` | `RANDOM_SEED` | +| `--chronological` | `CHRONOLOGICAL_ORDER=yes` | +| `--no-chronological` | `CHRONOLOGICAL_ORDER=no` | | `--shuffle` | `SHUFFLE=yes` | | `--no-shuffle` | `SHUFFLE=no` | | `--splash` | `SPLASH_PAGE=yes` | -- cgit v1.2.3