immich-docker/backlog/tasks/task-3 - Immich-Heatmap-Int...

51 lines
1.6 KiB
Markdown

---
id: task-3
title: Immich Heatmap Integration
status: Done
assignee: []
created_date: '2026-01-02 13:53'
labels:
- immich
- heatmap
- infrastructure
dependencies: []
priority: medium
---
## Description
<!-- SECTION:DESCRIPTION:BEGIN -->
Custom heatmap solution built for Immich photo library visualization. Allows clicking on map areas to view photos from that location in a gallery sidebar.
## What was done:
- Updated Immich to v2.4.1
- Enabled map/reverse geocoding in admin settings
- Built custom heatmap app (Node.js + Leaflet.js)
- Deployed at https://heatmap.jeffemmett.com
- Proxies API requests to Immich internal server to avoid CORS issues
## Power Tools Status:
⚠️ Immich Power Tools geo-heatmap feature is currently INCOMPATIBLE with Immich v2.4.x due to database schema changes (assetId column renamed). Awaiting Power Tools update for v2.4 compatibility.
## Custom Heatmap Features:
- Color gradient heatmap (blue→cyan→lime→yellow→red)
- Click anywhere to see photos from that area
- Gallery sidebar with thumbnails
- Lightbox view with prev/next navigation
- "Open in Immich" link for full photo view
- 84,162 photos with GPS data available
## Files:
- /opt/immich/heatmap-app/server.js - Node.js proxy server
- /opt/immich/heatmap-app/index.html - Frontend app
- /opt/immich/docker-compose.yml - Added heatmap service
<!-- SECTION:DESCRIPTION:END -->
## Acceptance Criteria
<!-- AC:BEGIN -->
- [ ] #1 Heatmap displays photo locations
- [ ] #2 Click on area shows photos in sidebar
- [ ] #3 Photos can be viewed in lightbox
- [ ] #4 Open in Immich link works
<!-- AC:END -->