jeffemmett
/
immich-docker
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
immich-docker/backlog/tasks/task-3 - Immich-Heatmap-Int...

1.6 KiB
Raw Permalink Blame History

id title status assignee created_date labels dependencies priority
task-3 Immich Heatmap Integration Done
2026-01-02 13:53
immich
heatmap
infrastructure
medium

Description

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

Acceptance Criteria

  • #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