From 9cc88ed2a6df8dbd3cda2f6d38c2a03524761023 Mon Sep 17 00:00:00 2001
From: Mees Frensel <33722705+meesfrensel@users.noreply.github.com>
Date: Sat, 8 Nov 2025 23:46:43 +0100
Subject: [PATCH] feat: make memories slideshow duration configurable (#22783)

---
 i18n/en.json                                  |   1 +
 .../openapi/lib/model/memories_response.dart  | Bin 2838 -> 3074 bytes
 mobile/openapi/lib/model/memories_update.dart | Bin 3234 -> 3932 bytes
 open-api/immich-openapi-specs.json            |   9 +++++++++
 open-api/typescript-sdk/src/fetch-client.ts   |   2 ++
 server/src/dtos/user-preferences.dto.ts       |   9 +++++++++
 server/src/types.ts                           |   1 +
 server/src/utils/preferences.ts               |   1 +
 .../memory-page/memory-viewer.svelte          |   2 +-
 .../feature-settings.svelte                   |  13 ++++++++++++-
 .../factories/preferences-factory.ts          |   1 +
 11 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/i18n/en.json b/i18n/en.json
index 30c8949ae..735e942dd 100644
--- a/i18n/en.json
+++ b/i18n/en.json
@@ -2027,6 +2027,7 @@
   "third_party_resources": "Third-Party Resources",
   "time": "Time",
   "time_based_memories": "Time-based memories",
+  "time_based_memories_duration": "Number of seconds to display each image.",
   "timeline": "Timeline",
   "timezone": "Timezone",
   "to_archive": "Archive",
diff --git a/mobile/openapi/lib/model/memories_response.dart b/mobile/openapi/lib/model/memories_response.dart
index b9f8b5d8b1862425c0c55c94ea6c383560c57168..cb42f596a6db652a8a110934e8feea0e5f8d26ab 100644
GIT binary patch
delta 220
zcmbOx)+Di^laV*2v?#G8Ge1wkR>4$fay_FmPi9_;0!(!BT*g)r7)Qa@79k<RR0x;Q
z%SbHFaL!Lj)l|@)T+ieWm#|fV>D5t~e2ytg3dU8B1=?4Vky)$<6WOfEe2~!y#<Nn$
yO)LmY%qdOvPYbCmNVNev%1$GzI6qHEp-3I3N?lV?XY)fAWi~Fjh|c7HToM3<ZcYCH

delta 56
zcmV-80LTA=7?u{Wi2;+K0U49Z0f3Wi0%Mcu0!fob18TF`1F`|L#swM%5@l{-Vr*q(
OCoBpeAbmRueF_Rtni9$Y

diff --git a/mobile/openapi/lib/model/memories_update.dart b/mobile/openapi/lib/model/memories_update.dart
index 71efd71ae78664f6340efbc6cdb381b29cf873d6..39c46ffd2f06bf841dbdb86e698f38451fa0e478 100644
GIT binary patch
delta 350
zcmZ1^c}H$TGb3k8X;ETHW`3T|<Vr?)K?UE;yv*FvT!pg4oYGV)1;fpg7!w$IGxJL9
z6<{hiPhfn=C<5at*xJHnCMPo&>L5$xmFDCq*ee()Si#jO>SZJrXE^7lq-rW?Pd>+-
z0yoK41*TO;VX_fRRy~ZXplGWAGD%aRno9u;vWoNbqKnjF3e;m2Y!yl}GK=+KBGzDq
zwF;>@#i>wT`uYkA*z|!+hAIbZ%1l$x0GqXW4$D7ALzszH3b}~|VW3d)PYbCmNVNfm
ViJb<>Kph1nmuTv2p2#N11^|Z2bgTdX

delta 42
zcmV+_0M-B89-<krg8`G40Tr{t0a^i*iv)j@ECpke!3AEEGX`q290&dZvs4KP233y^
Aq5uE@

diff --git a/open-api/immich-openapi-specs.json b/open-api/immich-openapi-specs.json
index d16e4c4e1..6076b43bf 100644
--- a/open-api/immich-openapi-specs.json
+++ b/open-api/immich-openapi-specs.json
@@ -12646,18 +12646,27 @@
       },
       "MemoriesResponse": {
         "properties": {
+          "duration": {
+            "default": 5,
+            "type": "integer"
+          },
           "enabled": {
             "default": true,
             "type": "boolean"
           }
         },
         "required": [
+          "duration",
           "enabled"
         ],
         "type": "object"
       },
       "MemoriesUpdate": {
         "properties": {
+          "duration": {
+            "minimum": 1,
+            "type": "integer"
+          },
           "enabled": {
             "type": "boolean"
           }
diff --git a/open-api/typescript-sdk/src/fetch-client.ts b/open-api/typescript-sdk/src/fetch-client.ts
index 435e10046..1ed65e4f2 100644
--- a/open-api/typescript-sdk/src/fetch-client.ts
+++ b/open-api/typescript-sdk/src/fetch-client.ts
@@ -152,6 +152,7 @@ export type FoldersResponse = {
     sidebarWeb: boolean;
 };
 export type MemoriesResponse = {
+    duration: number;
     enabled: boolean;
 };
 export type PeopleResponse = {
@@ -209,6 +210,7 @@ export type FoldersUpdate = {
     sidebarWeb?: boolean;
 };
 export type MemoriesUpdate = {
+    duration?: number;
     enabled?: boolean;
 };
 export type PeopleUpdate = {
diff --git a/server/src/dtos/user-preferences.dto.ts b/server/src/dtos/user-preferences.dto.ts
index b258158ae..452384b42 100644
--- a/server/src/dtos/user-preferences.dto.ts
+++ b/server/src/dtos/user-preferences.dto.ts
@@ -13,6 +13,12 @@ class AvatarUpdate {
 class MemoriesUpdate {
   @ValidateBoolean({ optional: true })
   enabled?: boolean;
+
+  @Optional()
+  @IsInt()
+  @IsPositive()
+  @ApiProperty({ type: 'integer' })
+  duration?: number;
 }
 
 class RatingsUpdate {
@@ -166,6 +172,9 @@ class RatingsResponse {
 
 class MemoriesResponse {
   enabled: boolean = true;
+
+  @ApiProperty({ type: 'integer' })
+  duration: number = 5;
 }
 
 class FoldersResponse {
diff --git a/server/src/types.ts b/server/src/types.ts
index 66045521d..0a2dd46d7 100644
--- a/server/src/types.ts
+++ b/server/src/types.ts
@@ -497,6 +497,7 @@ export interface UserPreferences {
   };
   memories: {
     enabled: boolean;
+    duration: number;
   };
   people: {
     enabled: boolean;
diff --git a/server/src/utils/preferences.ts b/server/src/utils/preferences.ts
index 121bf2826..b25369670 100644
--- a/server/src/utils/preferences.ts
+++ b/server/src/utils/preferences.ts
@@ -16,6 +16,7 @@ const getDefaultPreferences = (): UserPreferences => {
     },
     memories: {
       enabled: true,
+      duration: 5,
     },
     people: {
       enabled: true,
diff --git a/web/src/lib/components/memory-page/memory-viewer.svelte b/web/src/lib/components/memory-page/memory-viewer.svelte
index fe3569f91..cfe11e102 100644
--- a/web/src/lib/components/memory-page/memory-viewer.svelte
+++ b/web/src/lib/components/memory-page/memory-viewer.svelte
@@ -102,7 +102,7 @@
       });
     } else {
       progressBarController = new Tween<number>(0, {
-        duration: (from: number, to: number) => (to ? 5000 * (to - from) : 0),
+        duration: (from: number, to: number) => (to ? $preferences.memories.duration * 1000 * (to - from) : 0),
       });
     }
   };
diff --git a/web/src/lib/components/user-settings-page/feature-settings.svelte b/web/src/lib/components/user-settings-page/feature-settings.svelte
index 31a29be97..82a40161b 100644
--- a/web/src/lib/components/user-settings-page/feature-settings.svelte
+++ b/web/src/lib/components/user-settings-page/feature-settings.svelte
@@ -1,7 +1,9 @@
 <script lang="ts">
   import SettingAccordion from '$lib/components/shared-components/settings/setting-accordion.svelte';
+  import SettingInputField from '$lib/components/shared-components/settings/setting-input-field.svelte';
   import SettingSelect from '$lib/components/shared-components/settings/setting-select.svelte';
   import SettingSwitch from '$lib/components/shared-components/settings/setting-switch.svelte';
+  import { SettingInputFieldType } from '$lib/constants';
   import { preferences } from '$lib/stores/user.store';
   import { handleError } from '$lib/utils/handle-error';
   import { AssetOrder, updateMyPreferences } from '@immich/sdk';
@@ -18,6 +20,7 @@
 
   // Memories
   let memoriesEnabled = $state($preferences?.memories?.enabled ?? true);
+  let memoriesDuration = $state($preferences?.memories?.duration ?? 5);
 
   // People
   let peopleEnabled = $state($preferences?.people?.enabled ?? false);
@@ -43,7 +46,7 @@
         userPreferencesUpdateDto: {
           albums: { defaultAssetOrder },
           folders: { enabled: foldersEnabled, sidebarWeb: foldersSidebar },
-          memories: { enabled: memoriesEnabled },
+          memories: { enabled: memoriesEnabled, duration: memoriesDuration },
           people: { enabled: peopleEnabled, sidebarWeb: peopleSidebar },
           ratings: { enabled: ratingsEnabled },
           sharedLinks: { enabled: sharedLinksEnabled, sidebarWeb: sharedLinkSidebar },
@@ -103,6 +106,14 @@
           <div class="ms-4 mt-6">
             <SettingSwitch title={$t('enable')} bind:checked={memoriesEnabled} />
           </div>
+          <div class="ms-4 mt-6">
+            <SettingInputField
+              inputType={SettingInputFieldType.NUMBER}
+              label={$t('duration')}
+              description={$t('time_based_memories_duration')}
+              bind:value={memoriesDuration}
+            />
+          </div>
         </SettingAccordion>
 
         <SettingAccordion key="people" title={$t('people')} subtitle={$t('people_feature_description')}>
diff --git a/web/src/test-data/factories/preferences-factory.ts b/web/src/test-data/factories/preferences-factory.ts
index e7d556b00..f8ab8615b 100644
--- a/web/src/test-data/factories/preferences-factory.ts
+++ b/web/src/test-data/factories/preferences-factory.ts
@@ -23,6 +23,7 @@ export const preferencesFactory = Sync.makeFactory<UserPreferencesResponseDto>({
   },
   memories: {
     enabled: false,
+    duration: 5,
   },
   people: {
     enabled: false,