[Feature] Fallback configuration for Android widgets on launchers without reconfigure support

[leubeem]

I have searched the existing feature requests, both open and closed, to make sure this is not a duplicate request.

• Yes

The feature

[Feature] Fallback configuration for Android widgets on launchers without reconfigure support

The feature

The Android Random Photo widget currently uses:

android:configure="app.alextran.immich.widget.configure.RandomConfigure"
android:widgetFeatures="reconfigurable|configuration_optional"

This works as intended on launchers that implement Android's reconfigurable widget feature: the initial configuration can be skipped and the user can later long-press the widget and select "Reconfigure" or "Settings".

However, the OnePlus/OxygenOS launcher does not expose the reconfigure action for many third-party widgets.

This has been reproduced on a OnePlus 13 running OxygenOS 16. When adding the Immich Random Photo widget, it is added with its default configuration. Long-pressing it afterwards only allows resizing/removing it; there is no configuration/settings action.

As a result, there is no user-accessible way to select an album for the Random Photo widget.

This appears to be a OnePlus launcher limitation/bug rather than an Immich bug. The same missing reconfigure action has also been reported with other reconfigurable Android widgets on OnePlus devices.

Possible solution

It would be useful if Immich provided a launcher-independent fallback for configuring existing widgets.

For example:

• a "Configure widgets" section inside the Immich Android app
• an action inside the app that lists existing Random Photo widgets and opens RandomConfigure for the selected appWidgetId
• alternatively, not marking the initial configuration as configuration_optional

The first option would retain the current streamlined behaviour on launchers that properly support widget reconfiguration while also supporting launchers that do not.

Workaround / verification

The Immich configuration activity itself works correctly on the affected device.

After obtaining the widget ID using:

adb shell dumpsys appwidget

the configuration UI can be opened manually with:

adb shell am start \
  -n app.alextran.immich/.widget.configure.RandomConfigure \
  --ei appWidgetId <WIDGET_ID>

Album selection and saving then work normally.

Device

• OnePlus 13
• OxygenOS 16 / Android 16
• Immich Android Random Photo widget

Platform

• Server
• Web
• Mobile