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 4 of 10 platforms

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.

84/100 Excellent

Maintained
98last commit 45 days ago
Popular
682,409 GitHub stars
Easy to install
654 install platforms, install notes, Docker image
Light to run
No data
Security check
94no serious findings, 1 minor, CI, tests

Based on 4 of 5 factors.

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

GitHub stars
2,409
Open issues
96
Last commit
2026-10-07
Latest release
v1.0.39.0
License
GPL-3.0
Activity
declining

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

Resources & Compatibility

Requirements not published yet.

Checked 54 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 54 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 54 days ago - public community threads