aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-09-29 13:33:14 +0200
committerDanilo M. <danix@danix.xyz>2026-09-29 13:33:14 +0200
commit9624351d80ace747d3117fb22d6cbd00fce3eedf (patch)
treef9adc0a04445718d2d2b5e1b659b00fb8373c73c /README.md
parent272c5732b0bc932749f0e771de51ee49f6cebe5b (diff)
downloadconky-theme-udt-9624351d80ace747d3117fb22d6cbd00fce3eedf.tar.gz
conky-theme-udt-9624351d80ace747d3117fb22d6cbd00fce3eedf.zip
feat: add an Immich memories card with click and scroll
A centred card showing today's "N years ago" photos from Immich, one at a time on a 30-second rotation, with when each was taken and where. bin/immich-fetch.sh runs from conky's execi every 30 minutes: it asks /api/memories for today, converts each preview to PNG (Cairo loads nothing else) and writes an index with the year, local capture time and place. The place needs the key's asset.read permission and reads '--' without it. The key lives in ~/.config/udt/immich.env, like the weather key, because a GPG-backed store would raise a pinentry unattended. The dashboard now registers lua_mouse_hook and hands pointer events to the widget under the pointer. On this card, scrolling steps through the photos and a left click opens the photo in Immich's web UI and hides the dashboard so the browser is not stuck beneath it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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