Immich Cloud Photos

Dreaming-Codes

1.1.0 · GitHub

Download APK

File management Android 14+ 5 months ago GPL-3.0

29 ShizuStore

1.2k GitHub

185 Stars

3 MB Size

More about this app

Cloud media provider that surfaces a self-hosted Immich library in Android's system photo picker, configured via Shizuku or ADB.

Immich Cloud Photos

An Android Cloud Media Provider that integrates your self-hosted Immich server with the system photo picker. Browse and select your Immich photos and videos directly from any app that uses Android's built-in photo picker.

Installation

Or download the latest APK from the Releases page.

Requirements

Android 14+ (API 34)
An Immich server instance

Setup

Install the app and log in with your Immich server URL and credentials (email/password or API key).
Enable the cloud media provider via ADB (the app provides ready-to-copy commands):

# Set Immich Cloud Photos as the cloud media provider
adb shell device_config override mediaprovider allowed_cloud_providers codes.dreaming.cloudmedia

# For the debug build
adb shell device_config override mediaprovider allowed_cloud_providers codes.dreaming.cloudmedia.debug

Open any app's photo picker — your Immich library will appear as a cloud source.

Features

Browse all photos and videos from your Immich server in the system photo picker
Album support with full asset browsing
People/face recognition categories
Smart search across your library
Video playback with streaming support
Thumbnail previews and full-resolution downloads on demand

Building from source

# Debug build
./gradlew assembleDebug

# Release build
./gradlew assembleRelease

Requires JDK 17.

License

This project is not affiliated with or endorsed by Immich.

How Shizuku is used

Can register and unregister the app as a system photo picker cloud provider via `device_config` through Shizuku.

This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.

How this app uses Shizuku

Shizuku is used to allowlist this app as a cloud provider so a self-hosted Immich library appears in Android's system photo picker.

Enable cloud provider: tapping enable registers the app with the system photo picker using the device_config override shell command through Shizuku.
Disable cloud provider: tapping disable removes the registration using the device_config clear_override shell command through Shizuku.

Android APIs or commands used

device_config override mediaprovider allowed_cloud_providers
device_config clear_override mediaprovider allowed_cloud_providers

Notable details

The same enable and disable operations can be done without Shizuku by running the displayed ADB commands from a computer, which the app offers to copy.