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