Page:
Home
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
Table of contents
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.
Memories Wiki
Memories is a privacy-first, self-hosted photo and video management app. This wiki mirrors the curated documentation from the Memories repository; the repository remains the source of truth. Most pages here are generated, except the topic pages under docs/wiki/, which are maintained in the repository.
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 & Operations
- 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
Project
Reference
Architecture Decision Records
- ADR 0001: Face Clustering with Custom DBSCAN
- ADR 0001: Long-Term Domain Boundaries for Ownership, Sharing, People, and Workers
- ADR 0002: Class Instance Thumbnail Aspect Ratio
- ADR 0002: v1 Sharing Role and Permission Matrix
- ADR 0003: v1 Backup, Restore, and Export Guarantees
- ADR 0004: v1 Worker Security and Media Access
- ADR 0005: v1 Import Lifecycle and Failure Recovery
- ADR 0006: v1 Storage Backends, Layout, Integrity, and Garbage Collection
- ADR 0007: v1 Worker Protocol, Artifacts, and Idempotency
- ADR 0008: v1 Deployment Topology, Service Communication, and ML Model Profiles
- ADR 0009: v1 Modular Extension Boundaries
- ADR 0010: Core-Owned Face Embeddings and Candidate Person Matching
- ADR 0011: Immich-Like Owner-Wide Face Recognition and People Grouping
- ADR 0012: Collaborative Family Group Person Spaces
- ADR 0013: Shareable, Forkable Person Identities
- ADR 0014: Disable CLIP-Derived Visual Concept Labels Pending Semantic Search Redesign
- ADR 0015: Implement semantic search before redesigned Things labels
- 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 Automatic 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 and Instance Candidate Arbitration
- 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 Boundary
- ADR 0042: Per-Domain Household Display Terms
- ADR 0043: Parametrized Worker Capabilities
- ADR 0044: People as Generic Class-Occurrence Domain + Separate People Worker
- ADR 0045: ProgressiveImage Shared Component Pattern
- ADR 0046: Progressive Media Loading with Structural Skeletons
- ADR 0048: Day-bucketed Dynamic Loading UI
- ADR 0049: Two-Step Plant Discovery Pipeline
- ADR 0050: Plant YOLO confidence threshold = 0.5
- ADR 0051: Upgrade YOLO-World model from 's' to 'm'
- ADR 0054: Multi-Model Abstraction Layer for Plant Classification
- ADR 0055: Discovery Domain Edit Mode — User Marker Edits with Provenance
- ADR 0056: CLI Password Reset — Slim Spring Context, Trust Model, and Session Principal Indexing
- ADR 0093: Generic Class Instance Occurrence Embeddings
- ADR 0094: Discovery Instance Representative Thumbnail Must Use Extended Centered Square 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 under semisupervised-v1
- ADR 0103: Unified quality score ranks and displays every discovery suggestion
- ADR 0104: Constrained average-linkage clustering as opt-in semisupervised-v2 (DRAFT - pending user design approval)
- ADR 0104: Face scope-crop thumbnails derived by the media worker
- ADR 0105: Quality score C-isolation uses an absolute floor on the shared cosine scale
- ADR 0106: Confidence-aware target scoring: pessimistic distance for cluster_person_match target choice
- ADR 0107: Carousel suggestions and merge cards require a named target
- ADR 0108: Multi-representant person representation: per-mode centroids with per-representative pessimistic matching (semisupervised-v2)
- ADR 0109: API read-path multi-representant assignment metric: persisted worker representatives replace the live single-centroid ranking
- ADR 0110: Person gallery score sort reuses the 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: unlabeled×unlabeled + unlabeled×representative pairwise computation (semisupervised-v3)
- ADR 0113 validation plan — representative density graph (semisupervised-v3)
- ADR 0114: Representative thumbnail of a class instance is the manual pin or the medoid of its 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 constrained HAC: U ∪ R clustered together, identity from membership, same-run card merge with runner-up margin demotion (semisupervised-v4)
- ADR 0116 validation plan — identity-aware constrained HAC (semisupervised-v4)
- ADR 0117: Server-authoritative change feed with commit-ordered sequence cursor
- ADR 0118: Per-face age & gender estimation (MiVOLO v2, rev — supersedes genderage_v2 choice), birth-year person profiles, conservative generation-gap suggestion gate
- ADR 0119: Anchor-quality-gated identity evidence for semisupervised clustering (semisupervised-v6)
- ADR 0119: Ownership transfer is a DB-level ownership move with sender-scoped satellite cleanup, not a copy
- ADR 0120: Person attributes: manual birth-year & gender overrides, inferred gender consensus, gendered relation labels
- ADR 0121: Similarity suggestions rank above new-person clusters; qualityScore stays the ranking key within each group
- ADR 0122: Real-face multi-medoid identity representatives for semisupervised-v6 (amends ADR 0119, relativizes ADR 0108's centroid choice)
- ADR 0123: Pool-emission-quality gate: weak pool faces are recognized and marked, but never mint automatic suggestions (amends ADR 0119)
Development Documentation
- Agent Workflow
- Versioning
- Forgejo Deployment Pipeline
- CLI Password Reset
- Model Selection Report
- Playwright API Mock Fixtures — Patterns & Template
- Chromecast — deploymentkrav
- People Generic Consistency Diagnostics
- Runbook: Memories Android auf Google Play veröffentlichen
- Google Play review instance (
memories-review.wiwie.dk)
Changelog
- Changelog-V1.21.93
- Changelog-V1.21.92
- Changelog-V1.21.91
- Changelog-V1.21.90
- Changelog-V1.21.89
- Changelog-V1.21.88
- Changelog-V1.21.87
- Changelog-V1.21.86
- Changelog-V1.21.85
- Changelog-V1.21.84
- Changelog-V1.21.83
- Changelog-V1.21.82
- Changelog-V1.21.81
- Changelog-V1.21.80
- Changelog-V1.21.79
- Changelog-V1.21.78
- Changelog-V1.21.77
- Changelog-V1.21.76
- Changelog-V1.21.75
- Changelog-V1.21.27
- Changelog-V1.21.26
- Changelog-V1.21.25
- Changelog-V1.21.24
- Changelog-V1.21.23
- Changelog-V1.21.22
- Changelog-V1.21.21
- Changelog-V1.21.20
- Changelog-V1.21.19
- Changelog-V1.21.18
- Changelog-V1.21.17
- Changelog-V1.21.16
- Changelog-V1.21.15
- Changelog-V1.21.14
- Changelog-V1.21.13
- Changelog-V1.21.12
- Changelog-V1.21.11
- Changelog-V1.21.9
- Changelog-V1.21.8
- Changelog-V1.21.7
- Changelog-V1.21.5
- Changelog-V1.21.4
- Changelog-V1.21.3
- Changelog-1.12
- Changelog-V1.11
- Changelog-V1.09
- Changelog-1.06
- Changelog-1.03
- Changelog-V0.66
Synced from docs/
- Repo file — synced from docs/backup-restore-export.md on 2026-11-16
- Repo file — synced from docs/dev/agent-workflow.md on 2026-11-16
- Repo file — synced from docs/dev/versioning.md on 2026-11-16
- Repo file — synced from docs/dev/forgejo-deployment-pipeline.md on 2026-11-16
- Repo file — synced from docs/dev/cli-password-reset.md on 2026-11-16
- Repo file — synced from docs/dev/model-selection-report.md on 2026-11-16
- Repo file — synced from docs/dev/playwright-mock-fixtures.md on 2026-11-16
- Repo file — synced from docs/operator/people-generic-consistency.md on 2026-11-16
- Repo file — synced from docs/product-vision.md on 2026-11-16
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