Albums

Getting an albums ID from Immich

1. Open Immich’s web interface and click on “Albums” in the left-hand navigation.
2. Click on the album you want the ID of.
3. The url will now look something like this http://192.168.86.123:2283/albums/a04175f4-97bb-4d97-8d49-3700263043e5.
4. The album ID is everything after albums/, so in this example it would be a04175f4-97bb-4d97-8d49-3700263043e5.

Albums

The ID(s) of a specific album or albums you want to display.

Settings

Key	Value
CONFIG	albums
ENV	KIOSK_ALBUMS
URL	album
VALUE	[]string
DEFAULT	[]

Using with config.yaml file

albums:
  - ALBUM_ID
  - ALBUM_ID

Using with ENV in your docker-compose file

environment:
  KIOSK_ALBUMS: "ALBUM_ID, ALBUM_ID"

Using with url queries

http://{URL}?album=ALBUM_ID

Exclude albums

This feature allows you to prevent specific album assets from being displayed in the slideshow.

Note

Excluded albums take precedence over album selection methods. If an album is in both the selected albums and excluded albums lists, it will be excluded.

Settings

Key	Value
CONFIG	excluded_albums
ENV	KIOSK_EXCLUDED_ALBUMS
URL	excluded_albums
VALUE	[]string
DEFAULT	[]

Using with config.yaml file

excluded_albums:
  - ALBUM_ID
  - ALBUM_ID

Using with ENV in your docker-compose file

environment:
  KIOSK_ALBUM: "ALBUM_ID, ALBUM_ID"

Using with url queries

http://{URL}?excluded_albums=ALBUM_ID

Tip

You can remove excluded albums that were previously set in your config.yaml or environment variables by using none in the URL query parameters.

Example:

https://{URL}?album=ALBUM_ID&exclude_album=none

Album Order

Note

• When using multiple albums, the order of the albums is random.
• When using splitview layouts:
  • Kiosk will look for a second image with matching orientation
  • The second image shown may not be the next sequential image
  • Priority is given to finding images with the right aspect ratio for a balanced display

This controls the order in which the assets from the selected album(s) are displayed.

Settings

Key	Value
CONFIG	album_order
ENV	KIOSK_ALBUM_ORDER
URL	album_order
VALUE	random | newest | oldest
DEFAULT	random

Using with config.yaml file

album_order: random

Using with ENV in your docker-compose file

environment:
  KIOSK_ALBUM_ORDER: random

Using with url queries

http://{URL}?album_order=random

Special album keywords

all

Will use all albums (owned and shared). e.g. http://{URL}?album=all

owned

Will use all owned albums. e.g. http://{URL}?album=owned

shared

Will use only shared albums. e.g. http://{URL}?album=shared

favorites or favourites

Will use only favourited assets. e.g. http://{URL}?album=favorites or http://{URL}?album=favourites