Page:
Changelog V1.21.77
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
1
Changelog V1.21.77
Forgejo Actions edited this page 2026-10-14 08:13:02 +00:00
v1.21.77
Date: 2026-10-14
Features
- Video support (spec 059), Immich-parity timeline + viewer treatment for videos:
- Worker:
video_previewjob implemented via ffmpeg — generates a 512px JPEG poster thumbnail, a 2048px JPEG poster preview, and a ≤720p H.264/AAC MP4video_rendition(+faststart,yuv420p,-anwhen no audio stream) from one ffprobe-guided frame seek; robust unknown/short-duration seek handling, 10-minute per-invocation timeouts,video_preview_failedissues carrying the tool's stderr tail.extract_metadatanow handles videos via ffprobe (width/height/duration_millis/creation_timecapture timestamp with plausibility guard). ffmpeg added to the worker image;verifyRuntimewarns when ffmpeg/ffprobe are missing. Worker now heartbeats running jobs every 60s (lease was fixed at 300s, a long transcode could outlive it and get its uploads rejected). - API: new user-facing
GET /api/media/{id}/original— streams the original with the same owner/contribution/collaborative-people authorization as derived assets (predicate extracted to sharedMediaAuthorizationSql), inline Content-Disposition (RFC 5987), ETag/Last-Modified/private-immutable caching, and HTTP Range support (Spring MVC resource slicing; proven by test:Range: bytes=0-3→ 206 +Content-Range+Accept-Ranges).GET /api/media/{id}/derived/video_renditionis servable. Timeline items and media detail gainvideoRenditionUrl(videos with a rendition only) anddurationMillis. Upload commit enqueuesvideo_previewfor videos (photos excluded via a video-pixels gate). OpenAPI contract updated. This fixes the server half of Android video playback (KNOWN_ISSUES ISSUE-115 → mitigated). - Web: video tiles get a permanent glassy play badge (bottom-left) and a tabular-numerals duration pill (bottom-right,
m:ss/h:mm:ss); hovering (fine pointer, 250ms intent, suppressed in selection mode) crossfades the tile to a muted looping rendition preview — src is fetched only on first hover, released on leave/blur/scroll-away/selection entry; keyboard focus triggers the same preview; touch devices keep tap-to-open. The media viewer plays videos in a letterboxed<video controls autoplay playsinline>(keyed per item, sound-on with a graceful muted-fallback + "Ton einschalten" pill when autoplay policy blocks sound, poster + friendly message when nothing is playable), arrows keep working with seek priority while the player has focus, and the info panel shows Duration. New paraglide keys in en/de/da. Photo tiles are pixel-identical to before.
- Worker:
Notes
- Backend:
MediaJobHandlers/VideoTools(new; pure command builders + ffprobe JSON parsing, stubbedProcessRunnerseam for tests),MediaWorkerRunner(heartbeat executor),CoreApiWorkerClient(variant-discriminated idempotency keys for multi-artifactvideo_previewresults — without this results 2/3 would replay as cache hits and never be promoted),Dockerfile. Tests: MediaJobHandlersTest (56), MediaWorkerDrainTest (8) — 64/64 green; ffmpeg argv smoke-tested against real ffmpeg 6.1.1 (posters landscape/portrait, no-upscale cap, audio/no-audio renditions, faststart). - API:
MediaOriginalController+MediaAuthorizationSql(verbatim predicate extraction, zero behavior change),DerivedAssetController(video_rendition type),TimelineItem/MediaDetail/TimelineQueryService(rendition key aggregated in all 6 derived laterals; duration selected in all item queries; compat ctor keeps existing JSON field order),WorkerJobEnqueueService(requiresVideoPixels/supportsVideoPixels). Tests:MediaOriginalControllerTest(incl. Range),DerivedAssetControllerTest,TimelineQueryServiceTest,WorkerJobEnqueueServiceTest; full:apps:api:testgreen. - Web:
VideoTilePreview.svelte(self-contained tile treatment),hoverPreview.ts(DOM-free state machine + registry),videoUtils.ts(pure helpers), viewer/MediaGrid/MediaInfoPanel/Icon/messages changes. Tests: 25 new unit tests, Playwrightvideo-tiles.spec.ts(3 passed, mobile hover skipped by design);npm run checkclean (18 pre-existing warnings only), unit suite 239/239. - Known issues: ISSUE-115 → mitigated; new ISSUE-155 (pre-existing videos need a backfill/reprocess pass before they show posters), ISSUE-156 (original-streaming fallback until renditions exist), ISSUE-157 (video metadata extraction loads originals into heap — streaming download is future work).
- Version bump 1.21.76 → 1.21.77 (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