Page:
Changelog V1.21.82
Pages
ADR 0001 face clustering dbscan
ADR 0001 long term domain boundaries
ADR 0002 class instance thumbnail aspect ratio
ADR 0002 v1 sharing role permission matrix
ADR 0003 v1 backup restore export guarantees
ADR 0004 v1 worker security and media access
ADR 0005 v1 import lifecycle failure recovery
ADR 0006 v1 storage backends layout integrity gc
ADR 0007 v1 worker protocol artifacts idempotency
ADR 0008 v1 deployment topology service communication
ADR 0009 v1 modular extension boundaries
ADR 0010 core owned face embedding matching
ADR 0011 immich like owner wide face recognition
ADR 0012 collaborative family group person spaces
ADR 0013 shareable forkable person identities
ADR 0014 disable clip derived visual concept labels
ADR 0015 semantic search before redesigned things
ADR 0016 detector backed things pipeline
ADR 0017 constrained density retargeting for people
ADR 0018 map tile provider boundary
ADR 0019 semantic versioning and v1 release
ADR 0020 core owned typed discovery domains
ADR 0021 time location album suggestions
ADR 0022 reverse place lookup boundary
ADR 0023 postgis for reverse place lookup
ADR 0024 operator installed country region gazetteer imports
ADR 0025 normalized place label hierarchy
ADR 0026 place provider attribution surfacing
ADR 0027 place label cache staleness and title freeze
ADR 0028 reverse lookup precision policy
ADR 0029 managed geonames install and import controls
ADR 0030 geonames import source modes
ADR 0031 defer admin uploaded geonames files
ADR 0032 postgis deployment and restore validation
ADR 0033 geonames provider mapping validation gate
ADR 0034 place label language selection
ADR 0035 automatic album clustering research gate
ADR 0036 observation producer authority
ADR 0036 owner local learned album shape proposals
ADR 0037 collaborative class instances
ADR 0038 owner local class instance governance
ADR 0039 legacy people authority retirement boundary
ADR 0040 pre live legacy people removal
ADR 0041 pre 1 0 versioning and readiness
ADR 0042 domain display terms
ADR 0043 parametrized worker capabilities
ADR 0044 people generic class occurrence
ADR 0045 progressive image component
ADR 0046 progressive media loading
ADR 0048 day bucketed dynamic loading ui
ADR 0049 two step plant discovery
ADR 0050 plant yolo threshold
ADR 0051 upgrade yolo to medium
ADR 0054 multi model abstraction layer for plant classification
ADR 0055 discovery edit mode
ADR 0056 cli password reset slim context
ADR 0093 generic class instance occurrence embeddings
ADR 0094 discovery instance representative thumbnail crop
ADR 0095 per face crops via generic discovery thumbnail job
ADR 0096 opened media is a context preserving overlay
ADR 0097 stash auto assignments are tentative and never anchors
ADR 0097 upload session operations bind to creator (user or api credential)
ADR 0098 occurrence state is the sole confirmation axis
ADR 0098 standard filter and sort menu across media walls
ADR 0099 selection mode is unified across all media walls
ADR 0100 constrained density clustering for forward face recognition
ADR 0101 single pass semi supervised face clustering
ADR 0102 tentative occurrences are movable unlabeled pool members
ADR 0103 unified quality score for suggestion ranking
ADR 0104 constrained average linkage clustering as opt in semisupervised v2
ADR 0104 face scope crop thumbnails derived by the media worker
ADR 0105 quality score c isolation absolute floor
ADR 0106 confidence aware target scoring
ADR 0107 carousel suggestions named targets
ADR 0108 multi representant person representation
ADR 0109 api read path multi representant ranking
ADR 0110 person gallery score sort reuses face thumbnails read path
ADR 0111 per user ui locale preference and localized api messages
ADR 0112 stashing a named person discards the name
ADR 0113 representative density graph
ADR 0113 representative graph validation plan
ADR 0114 representative thumbnail is manual pin or medoid of largest cluster
ADR 0115 perceptual duplicate detection via dhash
ADR 0115 standard justified media wall is mandatory for every media visualization
ADR 0116 identity aware hac validation plan
ADR 0116 identity aware hac
ADR 0117 server authoritative change feed with commit ordered sequence cursor
ADR 0118 per face age & gender estimation (genderage_v2), birth year person profiles, conservative generation gap suggestion gate
ADR 0119 anchor quality gated identity evidence
ADR 0119 ownership transfer is a db level ownership move with sender scoped satellite cleanup, not a copy
ADR 0120 person attributes manual overrides inferred gender gendered relation labels
ADR 0121 similarity suggestions rank above new person clusters
ADR 0122 real face multi medoid representatives
ADR 0123 pool emission quality gate
Accounts Library And Export
Agents
Albums
Backup And Restore
Backup Restore Export
Changelog 1.03
Changelog 1.06
Changelog 1.12
Changelog V0.66
Changelog V1.09
Changelog V1.11
Changelog V1.21.11
Changelog V1.21.12
Changelog V1.21.13
Changelog V1.21.14
Changelog V1.21.15
Changelog V1.21.16
Changelog V1.21.17
Changelog V1.21.18
Changelog V1.21.19
Changelog V1.21.20
Changelog V1.21.21
Changelog V1.21.22
Changelog V1.21.23
Changelog V1.21.24
Changelog V1.21.25
Changelog V1.21.26
Changelog V1.21.27
Changelog V1.21.3
Changelog V1.21.4
Changelog V1.21.5
Changelog V1.21.7
Changelog V1.21.75
Changelog V1.21.76
Changelog V1.21.77
Changelog V1.21.78
Changelog V1.21.79
Changelog V1.21.8
Changelog V1.21.80
Changelog V1.21.81
Changelog V1.21.82
Changelog V1.21.83
Changelog V1.21.84
Changelog V1.21.85
Changelog V1.21.86
Changelog V1.21.87
Changelog V1.21.88
Changelog V1.21.89
Changelog V1.21.9
Changelog V1.21.90
Changelog V1.21.91
Changelog V1.21.92
Changelog V1.21.93
Cli Password Reset
Deployment Architecture
Dev Agent Workflow
Dev Cli Password Reset
Dev Forgejo Deployment Pipeline
Dev Model Selection Report
Dev Playwright Mock Fixtures
Dev Versioning
Explore Discovery Domains
Home
Known Issues And Diagnostics
Known Issues
Map Tiles And Places Privacy
Media Viewer Overlay
Operator Cast Requirements
Operator People Generic Consistency
Operator Play Publishing Runbook
Operator Play Review Instance
People And Faces
Places And Map
Plants
Privacy Policy
Progressive Image Loading
Readme
Search
Sharing And Households
Storage Layout
Timeline And Photos
Upgrades And Versioning
Uploading And Import
Vision
Workers
No results
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
v1.21.82
Date: 2026-10-17
Features
- Add photos to an existing album (spec 064, highlight): a new idempotent batch endpoint
POST /api/albums/{id}/items/batchadds many items to one album in a single transaction — safe to retry, unknown/inactive album or media normalize to 404 (#1278). On the web, an "Add to existing album" selection action plus a generalized multi-item dialog drive it from the timeline selection and the viewer (#1279); Android got a viewer "…" overflow menu and timeline multi-select with the same flow (#1280). Spec marked complete (#1281, #1282). - People clustering: semisupervised-v3 (ADR 0113): representative density-graph clustering in the people-worker behind a v3 result envelope, with the API-side contract matrix, allowlist and enqueue stamping (#1258, #1259), a V6 fingerprint-keyed representative cache (#1268, #1269), the accepted ADR and its measured G1/G4 validation trail (#1254, #1255, #1260–#1262, #1266, #1267, #1271).
- Canonical representative thumbnail (ADR 0114): one shared resolution ladder (manual pin via
manual_selection→ medoid of the largest cluster → deterministic fallback) now backs every face surface; the worker ships the medoid member face id per representative and the API re-enqueues the canonical crop on re-pin (#1276, #1277; confirmed-images-only rule #1283). - Family relations (spec 063): relations between persons (API #1236, web section with en/de/da i18n #1237), gender-neutral relation types (#1242), a relations carousel with chosen-representative thumbnails (#1245), derived and multi-level derived relations (#1248, #1253), and a picker that hides already-related persons (#1240). Spec marked complete (#1239).
- Album suggestions: runs auto-trigger after new imports (#1270) and are sorted by newest photo date (#1264).
- Cast follow-ups (Android): UX round 2 with always-visible cast button, chronology and day headers (#1228), the cast viewport crop mirror (spec 061, API + Android #1230/#1231), and a viewer autoplay slideshow (spec 062 #1234).
- Stash for named people (name discarded, ADR 0112): API + web, stash action moved to the instance-detail overflow menu (#1225, #1226, #1229). Web: Uploads moved into the mobile navigation drawer (#1256).
Fixes
- Android: backup keeps GPS EXIF again —
ACCESS_MEDIA_LOCATION+ original-byte reads prevent scrubbed copies from losing location on upload (#1275). - Worker: empty EXIF GPS treated as missing location; existing Null-Island (0,0) rows backfilled (#1272).
- API:
MediaTokenClaimis now Serializable —?st=media fetches no longer 500 after serving bytes, which had broken every Chromecast cast (ISSUE-160, #1227). - Ops:
worker_jobshistory bounded by a 30-day purge, ProcessingSummary index-covered (#1251); API JVM heap capped at 6% of host (JAVA_TOOL_OPTIONS, #1246). - Face suggestions: faster lookups with a regression guard (#1252), person-accurate dialog thumbnails (ISSUE-161, #1250), self-occurrences excluded from instance suggestions (#1244).
- Album suggestions: candidate-window anchors interleaved so recent media still gets windows (#1273); minimum 4 images (#1243); collapsed preview strips fixed (#1241).
- People-worker: single-source v3 envelope contract-version stamp (ISSUE-164, #1263);
releasedTentativeFacesfiltered to canonical UUIDs (ISSUE-165, #1265).
Notes
- Newly documented ADRs:
docs/adr/0113-representative-density-graph.md(semisupervised-v3, accepted) anddocs/adr/0114-canonical-representative-thumbnail.md. - Known-issues follow-ups: days with >500 photos still produce no suggestion window at all (ISSUE-166); the legacy single-item album endpoints can surface unknown/deleted albums as uncaught 500s — the spec 064 batch endpoint normalizes these, single-item path tracked as ISSUE-168.
- Android app releases 0.6.0–0.8.0 were merged to main during this window (#1224, #1232, #1235).
- Release: version bump 1.21.81 → 1.21.82 (PR branch, gradle.properties).
Memories Wiki
Using Memories
- Accounts, the Library Hub, and Data Export
- Albums and Automatic Suggestions
- Explore and Discovery Domains
- The Media Viewer
- People and Faces
- Places and Map
- Plants (In Development)
- Datenschutzerklärung (Privacy Policy)
- Fast, Progressive Image Loading
- Search
- Sharing and Households
- Timeline and Photos
- Uploading and Import
Self-Hosting
- Backup and Restore
- CLI Password Reset
- Deployment Architecture
- Known Issues and Operator Diagnostics
- Map Tiles and Place Data Privacy
- Storage Layout
- Upgrades and Versioning
- Workers
Reference