aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/README.md b/README.md
index 4956896..f16489a 100644
--- a/README.md
+++ b/README.md
@@ -91,6 +91,7 @@ six `${execi}` entries, even though that block renders nothing under Cairo.
${execi 1800 ~/.config/conky/bin/pubip-sample.sh}
${execi 900 ~/.config/conky/bin/slackware-sample.sh}
${execi 300 ~/.config/conky/bin/calendar-sample.sh}
+ ${execi 1800 ~/.config/conky/bin/immich-fetch.sh}
The disks sampler runs once a minute; the cache, Slackware and public-IP
samplers run every 15, 15 and 30 minutes respectively, because `du -sh
@@ -193,6 +194,25 @@ must be the day. A genuinely ambiguous pair like `03.04.2026` is read
day-first, matching khal's own defaults. A 2-digit year is refused rather than
guessed at.
+### Memories
+
+Today's "N years ago" photos from an Immich server, one at a time, rotating
+every 30 seconds. The big value is how many years ago; under the photo, when it
+was taken (the camera's local time) and where, as city and country, or
+coordinates when Immich has no place name for them.
+
+`bin/immich-fetch.sh` runs every 30 minutes. It asks `/api/memories` for
+today, downloads each photo's preview, converts it to PNG with ImageMagick
+(Cairo loads nothing else) and writes an index beside the photos in
+`~/.cache/udt/immich/`, dropping photos that are no longer today's. It needs
+`curl`, `jq` and `magick`, and a key in `~/.config/udt/immich.env`: copy
+`immich.env.example`. The key wants `memory.read` and `asset.view`; with
+`asset.read` too, the card shows the place, and without it the row reads `--`.
+
+The key sits in a plain file, like the weather key, because the fetch runs
+unattended from conky: reading it from a GPG-backed store would raise a
+pinentry whenever the agent's cache has expired.
+
### Host bindings
These hwmon bindings, and the ceilings beside them, are specific to this machine