9 Releases 9 Tags

RSS Feed

• v1.2.0 3cfcc3f983

  Compare

  v1.2.0 — URL params, person support, auto-refresh, app icon Stable

  jessikitty released this 2026-05-19 16:02:06 +10:00 | 65 commits to main since this release

  🖼️ Frambe v1.2.0

  New Features

  🔗 URL-based zero-touch launch
  Skip the setup screen entirely by passing query parameters in the URL:

  • ?album=ALBUM_UUID — show a specific album
  • ?person=PERSON_UUID — show photos of a specific person
  • ?favorites — show favorites only
  • ?random — show random photos

  Perfect for bookmarking different frame URLs on different tablets around the house.

  👤 Person/face support
  New API endpoints for Immich's people/face recognition:

  • Browse and display photos by person
  • Works via URL params (?person=UUID) for zero-touch setup

  🔄 Periodic album refresh
  The slideshow now checks for new photos added to the source (album/person/favorites) every 5 minutes by default. New photos are seamlessly merged into the current rotation without restarting. Configurable via REFRESH_INTERVAL env var.

  🎨 App icon

  • Frambe logo displayed on setup screen
  • Favicon and Apple touch icon for home screen bookmarks
  • Place FrambeIcon.png as public/img/icon.png in the container

  Changes

  • Default port changed from 3000 to 3030
  • When launched via URL params, the ✕ button reloads to the setup screen (strips params) instead of going back

  Config

  New environment variable:

  • REFRESH_INTERVAL — seconds between source refresh checks (default: 300)

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)