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

1. Install the app and log in with your Immich server URL and credentials (email/password or API key).
2. 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

3. 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.