Framewrk

Framewrk is a self-hosted photo-frame automation tool for people who want Aura and Nixplay digital frames kept filled from their own PhotoPrism or Immich…

  • Automation
  • Media Applications
  • Tools & Utilities
Framewrk is a self-hosted photo-frame automation tool for people who want Aura and Nixplay digital frames kept filled from their own PhotoPrism or Immich library. Point it at PhotoPrism, Immich, or both, add the frames you own, and it uploads the photos that match your rules on a schedule — at the right size and shape for each screen — and takes them back off when they no longer qualify. It remembers what it has already sent, so nothing is uploaded twice. Portrait and landscape frames each get what suits them. Send directly from the Framewrk iOS app or Photos Share Sheet without a photo library. Direct photos are independent of library rules, with delivery history and revocable device tokens. All state is one SQLite file under /data, so a backup is one file.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (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.

59/100 Fair

Maintained
81last commit 38 days ago
Popular
187 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
10032 MB minimum RAM, runs on ARM

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

GitHub stars
7
Open issues
1
Last commit
2026-10-14
Latest release
v1.3.3
Activity
declining

Checked 21 days ago - source: GitHub (smichalczyk/framewrk)

Resources & Compatibility

Minimum requirements: 32 MB RAM. ARM (e.g. Raspberry Pi) is supported.

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

First-install notes

  • First start Open the web console on port 8770 and sign in with the one-time password printed in the container log; no configuration is needed before the first start. source
  • Container setup Run Framewrk as one small container and use its web console for setup, monitoring, and logs. source

Fetched 38 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I sign in to Framewrk for the first time?

Open the console on port 8770 after the container starts. Find the one-time admin password in the container log, sign in, and choose your own password when asked.

What do I need before using Aura, Nixplay, or scheduled library sync?

You need an Aura and/or Nixplay account with at least one frame. For scheduled library sync, the PhotoPrism and/or Immich instance must be reachable.

How should I connect a PhotoPrism or Immich container on the same host?

Put Framewrk and the photo library container on one Docker network and address the library by its container name rather than a changing LAN address. If that still fails, network_mode host can work on Linux, but it ignores ports and puts the console directly on the host's port 8770.

Can I send photos from the Framewrk iOS app without a connected photo library?

Yes. Direct sends from the iOS app do not require a PhotoPrism or Immich library, but the Framewrk server must be reachable over HTTPS.

What PUID and PGID setting affects backup access?

Set PUID and PGID in compose.yaml to your own user and group. If you leave them unset, the data folder can end up owned by root, making it harder to read your own backup.

Answers sourced from hangframewrk.io

Community

Collected 47 days ago - public community threads