From e0caaf39b2e4236f2d1179cd5cf128a87913242d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ptit=20l=C3=A9gume?=
 <67562086+PtitLegume@users.noreply.github.com>
Date: Sun, 9 Aug 2026 01:21:51 +0200
Subject: [PATCH] feat(mobile): add random 4x2 flex window widget

---
 .../android/app/src/main/AndroidManifest.xml  | 15 +++++++++++++
 .../immich/widget/FlexWindowReceivers.kt      |  2 ++
 .../app/src/main/res/values/strings.xml       |  1 +
 .../main/res/xml/random_widget_flex_4x2.xml   | 21 +++++++++++++++++++
 mobile/lib/constants/constants.dart           |  1 +
 5 files changed, 40 insertions(+)
 create mode 100644 mobile/android/app/src/main/res/xml/random_widget_flex_4x2.xml

diff --git a/mobile/android/app/src/main/AndroidManifest.xml b/mobile/android/app/src/main/AndroidManifest.xml
index 99a1a6e6b6..c6f0232bb6 100644
--- a/mobile/android/app/src/main/AndroidManifest.xml
+++ b/mobile/android/app/src/main/AndroidManifest.xml
@@ -224,6 +224,21 @@
         android:resource="@xml/samsung_appwidget_sub_screen" />
     </receiver>
 
+    <receiver
+      android:name=".widget.RandomReceiverFlex4x2"
+      android:exported="true"
+      android:label="@string/random_widget_flex_4x2_title">
+      <intent-filter>
+        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+      </intent-filter>
+      <meta-data
+        android:name="android.appwidget.provider"
+        android:resource="@xml/random_widget_flex_4x2" />
+      <meta-data
+        android:name="com.samsung.android.appwidget.provider"
+        android:resource="@xml/samsung_appwidget_sub_screen" />
+    </receiver>
+
     <activity android:name=".widget.configure.RandomConfigure"
       android:exported="true"
       android:theme="@style/Theme.Material3.DayNight.NoActionBar">
diff --git a/mobile/android/app/src/main/kotlin/app/alextran/immich/widget/FlexWindowReceivers.kt b/mobile/android/app/src/main/kotlin/app/alextran/immich/widget/FlexWindowReceivers.kt
index aae500270c..fd43f71fcf 100644
--- a/mobile/android/app/src/main/kotlin/app/alextran/immich/widget/FlexWindowReceivers.kt
+++ b/mobile/android/app/src/main/kotlin/app/alextran/immich/widget/FlexWindowReceivers.kt
@@ -7,3 +7,5 @@ class MemoryReceiverFlex2x2 : MemoryReceiver()
 class MemoryReceiverFlex4x2 : MemoryReceiver()
 
 class RandomReceiverFlex2x2 : RandomReceiver()
+
+class RandomReceiverFlex4x2 : RandomReceiver()
diff --git a/mobile/android/app/src/main/res/values/strings.xml b/mobile/android/app/src/main/res/values/strings.xml
index 4897b5bd1e..89b6384ae4 100644
--- a/mobile/android/app/src/main/res/values/strings.xml
+++ b/mobile/android/app/src/main/res/values/strings.xml
@@ -6,6 +6,7 @@
   <string name="memory_widget_flex_2x2_title">Memories (2x2)</string>
   <string name="memory_widget_flex_4x2_title">Memories (4x2)</string>
   <string name="random_widget_flex_2x2_title">Random (2x2)</string>
+  <string name="random_widget_flex_4x2_title">Random (4x2)</string>
 
   <string name="memory_widget_description">See memories from Immich.</string>
   <string name="random_widget_description">View a random image from your library or a specific album.</string>
diff --git a/mobile/android/app/src/main/res/xml/random_widget_flex_4x2.xml b/mobile/android/app/src/main/res/xml/random_widget_flex_4x2.xml
new file mode 100644
index 0000000000..5baa4e01c0
--- /dev/null
+++ b/mobile/android/app/src/main/res/xml/random_widget_flex_4x2.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Random widget for the Samsung Flex Window cover screen, full width of its 4x2 grid. -->
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+  xmlns:app="http://schemas.android.com/apk/res-auto"
+  xmlns:tools="http://schemas.android.com/tools"
+  android:initialLayout="@layout/glance_default_loading_layout"
+  android:minWidth="304dp"
+  android:minHeight="128dp"
+  android:targetCellWidth="4"
+  android:targetCellHeight="2"
+  android:resizeMode="none"
+  android:widgetCategory="keyguard"
+  android:updatePeriodMillis="1200000"
+  android:configure="app.alextran.immich.widget.configure.RandomConfigure"
+  android:widgetFeatures="reconfigurable|configuration_optional"
+  app:targetHost="4"
+  app:widgetSize="16"
+  tools:targetApi="31"
+  android:description="@string/random_widget_description"
+  android:previewImage="@drawable/random_preview"
+  />
diff --git a/mobile/lib/constants/constants.dart b/mobile/lib/constants/constants.dart
index 3ccab26408..cadb896c42 100644
--- a/mobile/lib/constants/constants.dart
+++ b/mobile/lib/constants/constants.dart
@@ -44,6 +44,7 @@ const List<(String, String)> kWidgetNames = [
   ('com.immich.widget.memory', 'app.alextran.immich.widget.MemoryReceiverFlex2x2'),
   ('com.immich.widget.memory', 'app.alextran.immich.widget.MemoryReceiverFlex4x2'),
   ('com.immich.widget.random', 'app.alextran.immich.widget.RandomReceiverFlex2x2'),
+  ('com.immich.widget.random', 'app.alextran.immich.widget.RandomReceiverFlex4x2'),
 ];
 
 const int kMinMonthsToEnableScrubberSnap = 12;