← Directory

ImmichFrame

ImmichFrame is a digital photo frame client that connects to an Immich server and displays your photo library on a supported frame or Android device.

  • Media Applications
  • Media Servers
  • Other
  • Tools & Utilities
ImmichFrame is a digital photo frame client that connects to an Immich server and displays your photo library on a supported frame or Android device. It is for self-hosters who want a self-managed slideshow without a public cloud frame service, and it is not affiliated with Immich.

Platform availability

Available on 3 of 9 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

80/100 Excellent

Maintained
100last commit 8 days ago
Popular
672,362 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 17 days ago

GitHub stars
2,362
Open issues
86
Last commit
2026-10-07
Latest release
v1.0.39.0
License
GPL-3.0
Activity
rising

Checked 8 days ago - source: GitHub (immichFrame/ImmichFrame)

Resources & Compatibility

Requirements not published yet.

Checked 17 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set the Docker config path and port In the Docker Compose file (the startup script for the app), replace PATH/TO/CONFIG with a real folder that will hold ImmichFrame's settings and keep the 8080 port line (the numbered address your frame uses to find the app). Without the settings folder and the correct port, the app can lose its configuration or your frame cannot reach it. source
  • Install the Frameo app file Use ADB (the Android command-line tool) to install the ImmichFrame APK file (the Android app file) on your Frameo, and double-check that the path to the .apk file is correct. If the path is wrong or the app is not installed, you will have nothing to launch and configure. source
  • Enter the Immich server details After the app is installed, run the ADB command to start ImmichFrame, then swipe down into its settings and enter the server URL and authorization secret (a shared password/token). Without those details, the frame does not know which Immich server to connect to, so it will not show your photos. source

Fetched 17 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which Docker Compose values should I change for ImmichFrame to keep working on a frame?

Replace the placeholder config path with a real folder that will store ImmichFrame's settings. Keep the 8080 port line so the frame can reach the app.

How do I install ImmichFrame on a Frameo Android frame and point it at my server?

Use ADB to install the ImmichFrame APK on the Frameo and check the APK path. After launching the app, open its settings and enter the Immich server URL and authorization secret.

Can ImmichFrame show videos from my Immich library?

Yes, ImmichFrame can display videos, but video playback is experimental and disabled by default. Enable it by setting ShowVideos: true in the account configuration.

Can I customize the ImmichFrame slideshow?

Yes, you can customize the slideshow.

Answers sourced from github.com, github.com, immichframe.dev, immichframe.dev

Community

Collected 16 days ago - public community threads