damongolding/immich-kiosk v0.15.0 on GitHub

landscape and portrait layouts

You can now specify landscape or portrait as a layout value to display images with the desired aspect ratio.

New asset "buckets"

You can now use date ranges and memories in addition to albums and people.

Date range

Warning

I have found an issue in the Immich API which means that the date range is not working as expected.
It seems API is matching against "createdBefore" and "createdAfter" instead of the EXIF meta data.
I have raised this with the Immich team and will update this when it is fixed.

Tip

You can use today as an alias for the current date.
e.g. http://{URL}?date=2023-01-01_to_today

Define specific date ranges to filter images as a source:

via config.yaml file

date:
  - "YYYY-MM-DD_to_YYYY-MM-DD"

via ENV in your docker-compose file use a , to separate IDs

environment:
  KIOSK_DATE: "DATE_RANGE,DATE_RANGE,DATE_RANGE"

via url quires

http://{URL}?date=DATE_RANGE&date=DATE_RANGE&date=DATE_RANGE

Read the Docs

Memories

Enable image memories as a source:

via config.yaml file

memories: true

via ENV in your docker-compose file

environment:
  KIOSK_MEMORIES: true

via url quires

http://{URL}?memories=true

Album order

Choose in what order albums are displayed. random (default), newest or oldest.

via config.yaml file

album_order: random

via ENV in your docker-compose file

environment:
  KIOSK_ALBUM_ORDER: random

via url quires

http://{URL}?album_order=random

Read the Docs

local language for image metadata date

Set the LANG environment variable to one of the supported language codes to localize image metadata dates.

Example:

services:
  immich-kiosk:
    image: damongolding/immich-kiosk:latest
    container_name: immich-kiosk
    tty: true
    environment:
      LANG: "en_GB"
      TZ: "Europe/London"
    ports:
      - 3000:3000
    volumes:
      - ./config:/config
      # - ./custom.css:/custom.css
    restart: always

Per device cache

Each kiosk device now uses its own cache for API calls, significantly reducing duplicate images (especially within albums).

Dynamic manifest for PWA

On iOS, PWAs (Progressive Web Apps) cannot use URL queries directly. To address this limitation, Kiosk now supports dynamic manifest creation, enabling query overrides to function correctly when used in tandem with Kiosk's internal redirects.

How it works

kiosk:
  redirects:
    - name: pwa
      url: ?layout=portrait&album=ALBUM_ID
      type: internal

By configuring the above internal redirect and navigating to http://{URL}/pwa, you can set the start URL for the PWA. When added to the home screen, the app will respect the specified URL query overrides.

What's Changed

🚀 New Features

linear transition for smoother zooming by @damongolding in #240
add landscape and portrait layouts by @damongolding in #254
add date range asset bucket by @damongolding in #251
add memories asset bucket by @damongolding in #266
disable gpu option by @damongolding in #257
add local language for image meta date by @damongolding in #259
per device cache and random album asset rework by @damongolding in #252
dynamic manifest by @damongolding in #262
album ordering by @damongolding in #265

⚡ Fixes

fix clock/weather container height on older browsers by @damongolding in #258
fix for clock when using disable_ui by @damongolding in #264

Full Changelog: v0.14.7...v0.15.0