Immich-Kiosk

Immich-Kiosk

Docker app from grtgbln's Repository

Overview

A web slideshow for Immich

Immich Kiosk





Links

What is Immich Kiosk?

Highly configurable slideshows for displaying Immich assets on browsers and devices.

[!IMPORTANT] This project is not affiliated with Immich


Support

If this project has been helpful to you and you wish to support me, you can do so with the button below 🙂.

"Buy Me A Coffee"


Help

If you have found a bug or have an issue you can submit it here.

If you'd like to chat or need some informal help, feel free to find me in the Kiosk channel on the Immich discord server.

Discord button

AI usage

Immich Kiosk is hand-curated without any direct AI assistance.

We use CodeRabbit to review code changes, but it is mainly used to provide feedback (which is often ignored), catch bugs, and fix my many typos.

Install Immich-Kiosk on Unraid in a few clicks.

Find Immich-Kiosk in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Immich-Kiosk Review the template variables and paths Click Install

Requirements


        Requires a separate Immich server. Container requires a "config.yaml" file at the "Config File" path BEFORE starting if using config file; otherwise use environmental variables. See the project page for more information: https://github.com/damongolding/immich-kiosk?tab=readme-ov-file#configuration
    

Download Statistics

240,952
Total Downloads
4,665
This Month
3,964
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
damongolding/immich-kiosk:latest
Last Updated2025-04-07
First Seen2024-09-04

Runtime arguments

Web UI
http://[IP]:[PORT:3000]
Network
bridge
Privileged
false

Template configuration

Web UI PortPorttcp

Container Port: 3000

Target
3000
Default
3000
Value
3000
Config FilePathrw

Config file for application. Remove this if using environmental variables instead.

Target
/config.yaml
Default
/mnt/user/appdata/immich_kiosk/config.yaml
Value
/mnt/user/appdata/immich_kiosk/config.yaml
Immich URLVariable

The URL to the Immich Server

Target
KIOSK_IMMICH_URL
Immich API KeyVariable

The API for your Immich server

Target
KIOSK_IMMICH_API_KEY
Disable Kiosk UIVariable

A shortcut to set KIOSK_SHOW_TIME, KIOSK_SHOW_DATE, KIOSK_SHOW_IMAGE_TIME and KIOSK_SHOW_IMAGE_DATE

Target
KIOSK_DISABLE_UI
Default
false|true
Show current timeVariable

Display current time

Target
KIOSK_SHOW_TIME
Default
true|false
Current time formatVariable

Display current time in either 12-hour or 24-hour format

Target
KIOSK_TIME_FORMAT
Default
12|24
Show current dateVariable

Display the current date

Target
KIOSK_SHOW_DATE
Default
true|false
Current date formatVariable

The format of the current date. Any GO date string is valid

Target
KIOSK_DATE_FORMAT
Default
DD/MM/YYYY
Value
DD/MM/YYYY
Refresh intervalVariable

The amount in seconds a image will be displayed for

Target
KIOSK_REFRESH
Default
60
Value
60
Specific albumVariable

The ID(s) of a specific album or albums you want to display. See FAQ: How do I set multiple albums? to see how to implement this

Target
KIOSK_ALBUM
Specific personVariable

The ID(s) of a specific person or people you want to display. See FAQ: How do I set multiple people? to see how to implement this

Target
KIOSK_PERSON
Image fitVariable

How your image will fit on the screen. Default is contain. See Image fit for more info

Target
KIOSK_IMAGE_FIT
Default
contain|cover|none
Add blurred backgroundVariable

Display a blurred version of the image as a background

Target
KIOSK_BACKGROUND_BLUR
Default
true|false
Image transitionVariable

Which transition to use when changing images

Target
KIOSK_TRANSITION
Default
none|fade|cross-fade
Show progress barVariable

Display a progress bar for when image will refresh

Target
KIOSK_SHOW_PROGRESS
Default
true|false
Show image timeVariable

Display image time from metadata (if available)

Target
KIOSK_SHOW_IMAGE_TIME
Default
true|false
Image time formatVariable

Display image time in either 12-hour or 24-hour format

Target
KIOSK_IMAGE_TIME_FORMAT
Default
12|24
Show image dateVariable

Display the image date from metadata (if available)

Target
KIOSK_SHOW_IMAGE_DATE
Default
true|false
Image date formatVariable

The format of the image date. default is day/month/year. Any GO date string is valid.

Target
KIOSK_IMAGE_DATE_FORMAT
Default
DD/MM/YYYY
Value
DD/MM/YYYY
PasswordVariable

See FAQs for more info. If set, requests must contain the password in the GET parameters e.g. http://192.168.0.123:3000?password=PASSWORD.

Target
KIOSK_PASSWORD
Cache imagesVariable

Cache selective Immich api calls to reduce unnecessary calls

Target
KIOSK_CACHE
Default
true|false