S
ShizuPortal
ShizuStore

Unofficial ShizuStore Web Portal

This is an unofficial web portal for ShizuStore self-hosted by rdevz-ph. Visit the official portal at https://shizustore.com/.

CatalogFile managementimmich-cloud-media
immich-cloud-media

immich-cloud-media

v2.1.2
by Dreaming-Codes•File management•GPL-3.0
Need ShizuStore app? Download APK

About Application

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.

image

Installation

Get it on Obtainium

Or download the latest APK from the Releases page.

Requirements

  • Android 13 or later (API 33)
  • An Immich server instance

Setup

  1. Install the app and log in with your Immich server URL and credentials (email/password or API key). If you use an API key, give it the six permissions below.
  2. Enable the cloud media provider via ADB. The app shows the right command for your Android version, ready to copy, and can also run it through Shizuku.
# Android 15 and later
adb shell device_config override mediaprovider allowed_cloud_providers codes.dreaming.cloudmedia

# Android 14
adb shell device_config put mediaprovider allowed_cloud_providers codes.dreaming.cloudmedia

# Android 13
adb shell device_config put storage_native_boot allowed_cloud_providers codes.dreaming.cloudmedia.cloudmedia
adb shell device_config put mediaprovider allowed_cloud_providers codes.dreaming.cloudmedia

For the debug build, replace codes.dreaming.cloudmedia with codes.dreaming.cloudmedia.debug in each command. Android 13 and 14 have no override command. A server flag sync can reset a value set with put, so run it again if Immich disappears from the picker. If the picker does not show Immich right away, reboot the phone.

Android 13 needs two commands because the setting moved. The MediaProvider that ships with Android 13 reads the provider authority from storage_native_boot, and only when it starts, so reboot after you run the commands. A MediaProvider updated through Google Play system updates reads the package name from mediaprovider.

  1. Open any app's photo picker. Your Immich library appears as a cloud source.

An API key needs six permissions

If you log in with an API key, give the key these permissions in Immich under Account Settings > API Keys. Email/password and SSO logins do not use them. Endpoint paths are relative to your server's /api.

PermissionEndpoints the app callsUsed for
user.readGET /users/meChecking the key at login and showing the account name
album.readGET /albumsListing albums
asset.readGET /timeline/buckets, POST /search/metadata, POST /search/smartListing the timeline, album contents, and search results, and detecting new and deleted photos
asset.viewGET /assets/{id}/thumbnail, GET /assets/{id}/video/playbackThumbnails, previews, and video playback
asset.downloadGET /assets/{id}/originalFull-resolution files
person.readGET /people, GET /people/{id}/thumbnailPeople and their face thumbnails

A key with all also works. The key does not need sync.stream. With an API key, the app checks GET /timeline/buckets for changes and never calls the sync endpoints, because Immich 3 rejects API keys there.

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 (Android 16 and later)
  • Smart search across your library (Android 16 and later)
  • 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.

Release Notes & Changelog

Fixes

  • Cloud media on first open. The picker could open without your Immich photos the first time it connected to the app after a restart. Android hides cloud media until the app returns its library info, and the app waited for a server request before it answered. The app now returns the library info it already has right away, then checks the server in the background. (#29, #30, closes #28 reported by @TrafficDemotion)
  • Change notifications. When the app found new or deleted photos, its notification never reached the picker. The app now uses the Android API for cloud media changes, so the picker syncs again on its own. (#30)
  • Deleted photos. The app could mark deletions as seen on the server before the picker read them, so the picker could miss them. Repeated change checks also restarted the sync for the same changes. Each set of changes now triggers one sync, and the app keeps it until the picker reads the deletions and the server confirms them. (#30)

Full Changelog: https://github.com/Dreaming-Codes/immich-cloud-media/compare/v2.1.1...v2.1.2

Declared Android Permissions

7 total

Shizuku API Permissions

moe.shizuku.manager.permission.API_V23

This application connects to the Shizuku service to execute system-level operations with ADB elevated privileges.

Standard Android Permissions

INTERNET
ACCESS_NETWORK_STATE
com.android.providers.media.permission.MANAGE_CLOUD_MEDIA_PROVIDERS
READ_MEDIA_IMAGES
READ_MEDIA_VIDEO
codes.dreaming.cloudmedia.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION

Specifications

Packagecodes.dreaming.cloudmedia
LicenseGPL-3.0
GitHub Stars205
Installs121
Target SDKAndroid 14+ (API 36)
Last UpdatedOctober 23, 2026
Release DateNovember 17, 2026
Root RequirementRootless (Shizuku)
ShizuStore Installation

Install via ShizuStore to enable automatic updates and silent installations using Shizuku.

More in File management

Other applications in this category

View all (7)