ImmichKiosk

ImmichKiosk

Application Docker from DamonGolding's Repository

Vue d'ensemble

Immich Kiosk is a lightweight slideshow for running on kiosk devices and browsers that uses Immich as a data source.

Exigences

A reachable Immich server that is running version v1.127.0 or above. See the project page for more information: https://github.com/damongolding/immich-kiosk?tab=readme-ov-file

Arguments d'exécution

Interface utilisateur Web
http://[IP]:[PORT:3000]
Réseau
bridge
Coquille
sh
Privilégié
false

Configuration du modèle

LanguageVariable

The language code for Kiosk to use

Cible
LANG
Défaut
en_US|en_GB|da_DK|nl_BE|nl_NL|fi_FI|fr_FR|fr_CA|de_DE|hu_HU|it_IT|nn_NO|nb_NO|pl_PL|pt_PT|pt_BR|ro_RO|ru_RU|es_ES|ca_ES|sv_SE|tr_TR|uk_UA|bg_BG|zh_CN|zh_TW|zh_HK|ko_KR|ja_JP|el_GR|id_ID|fr_GP|fr_LU|fr_MQ|fr_GF|fr_RE|cs_CZ|sl_SI|lt_LT|et_EE|hr_HR|lv_LV|sk_SK|th_TH|uz_UZ|kk_KZ
Valeur
en_GB
TimezoneVariable

The timezone for Kiosk to use

Cible
TZ
Valeur
Europe/London
Web UI PortPorttcp

Container Port: 3000

Cible
3000
Défaut
3000
Valeur
3000
Config FilePathrw

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

Cible
/config.yaml
Défaut
/mnt/user/appdata/immich_kiosk/config.yaml
Immich Api KeyVariable

The API for your Immich server.

Cible
KIOSK_IMMICH_API_KEY
Immich UrlVariable

The URL of your Immich server. MUST include a port if one is needed e.g. `http://192.168.1.123:2283`.

Cible
KIOSK_IMMICH_URL
Immich External UrlVariable

The public URL of your Immich server used for generating links and QR codes.

Cible
KIOSK_IMMICH_EXTERNAL_URL
Show TimeVariable

Display clock.

Cible
KIOSK_SHOW_TIME
Défaut
false|true
Valeur
false
Time FormatVariable

Display clock time in either 12-hour or 24-hour format. This can either be 12 or 24.

Cible
KIOSK_TIME_FORMAT
Défaut
24|12
Valeur
24
Show DateVariable

Display the date.

Cible
KIOSK_SHOW_DATE
Défaut
false|true
Valeur
false
Date FormatVariable

The format of the date. default is day/month/year.

Cible
KIOSK_DATE_FORMAT
Défaut
DD/MM/YYYY
Valeur
DD/MM/YYYY
Clock SourceVariable

The source of the clock. Either client or server.

Cible
KIOSK_CLOCK_SOURCE
Défaut
client|server
Valeur
client
DurationVariable

The amount in seconds an image will be displayed for.

Cible
KIOSK_DURATION
Défaut
60
Valeur
60
Disable ScreensaverVariable

Ask browser to request a lock that prevents device screens from dimming or locking. NOTE: I haven't been able to get this to work consistently on IOS.

Cible
KIOSK_DISABLE_SCREENSAVER
Défaut
false|true
Valeur
false
Optimize ImagesVariable

Whether Kiosk should resize images to match your browser screen dimensions for better performance. NOTE: In most cases this is not necessary, but if you are accessing Kiosk on a low-powered device, this may help.

Cible
KIOSK_OPTIMIZE_IMAGES
Défaut
false|true
Valeur
false
Use GpuVariable

Enable GPU acceleration for improved performance (e.g., CSS transforms)

Cible
KIOSK_USE_GPU
Défaut
true|false
Valeur
true
Show ArchivedVariable

Allow assets marked as archived to be displayed.

Cible
KIOSK_SHOW_ARCHIVED
Défaut
false|true
Valeur
false
AlbumsVariable

The ID(s) of one or more albums to display.

Cible
KIOSK_ALBUMS
Album OrderVariable

The order an album's assets will be displayed.

Cible
KIOSK_ALBUM_ORDER
Défaut
random|newest|oldest
Valeur
random
Excluded AlbumsVariable

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

Cible
KIOSK_EXCLUDED_ALBUMS
Show VideosVariable

Enable video playback.

Cible
KIOSK_SHOW_VIDEOS
Défaut
false|true
Valeur
false
Live PhotosVariable

Enable live photos playback for albums.

Cible
KIOSK_LIVE_PHOTOS
Défaut
false|true
Valeur
false
Live Photo Loop DelayVariable

Delay in seconds before looping live photos.

Cible
KIOSK_LIVE_PHOTO_LOOP_DELAY
Défaut
0
Valeur
0
PeopleVariable

The ID(s) of a specific person or people you want to display.

Cible
KIOSK_PEOPLE
Require All PeopleVariable

Require all people to be present in an asset.

Cible
KIOSK_REQUIRE_ALL_PEOPLE
Défaut
false|true
Valeur
false
Excluded PeopleVariable

The ID(s) of a specific person or people you want to exclude.

Cible
KIOSK_EXCLUDED_PEOPLE
DatesVariable

A date range or ranges.

Cible
KIOSK_DATES
TagsVariable

Tag or tags you want to display.

Cible
KIOSK_TAGS
Excluded TagsVariable

The tag or tags you want to exclude.

Cible
KIOSK_EXCLUDED_TAGS
MemoriesVariable

Display memories.

Cible
KIOSK_MEMORIES
Défaut
false|true
Valeur
false
BlacklistVariable

The ID(s) of any specific assets you want Kiosk to skip/exclude from displaying.

Cible
KIOSK_BLACKLIST
Date FilterVariable

Filter person and random assets by date.

Cible
KIOSK_DATE_FILTER
Disable NavigationVariable

Disable all Kiosk's navigation (touch/click, keyboard and menu).

Cible
KIOSK_DISABLE_NAVIGATION
Défaut
false|true
Valeur
false
Disable UiVariable

A shortcut to set show_time, show_date, show_image_time and show_image_date to false.

Cible
KIOSK_DISABLE_UI
Défaut
false|true
Valeur
false
Menu PositionVariable

Sets the position of the menu bar.

Cible
KIOSK_MENU_POSITION
Défaut
top|bottom
Valeur
top
FramelessVariable

Remove borders and rounded corners on images.

Cible
KIOSK_FRAMELESS
Défaut
false|true
Valeur
false
Hide CursorVariable

Hide cursor/mouse via CSS.

Cible
KIOSK_HIDE_CURSOR
Défaut
false|true
Valeur
false
Font SizeVariable

The base font size for Kiosk. Default is 100% (16px). DO NOT include the % character.

Cible
KIOSK_FONT_SIZE
Défaut
100
Valeur
100
Background BlurVariable

Display a blurred version of the image as a background.

Cible
KIOSK_BACKGROUND_BLUR
Défaut
true|false
Valeur
true
Background Blur AmountVariable

The amount of blur to apply to the background image (sigma).

Cible
KIOSK_BACKGROUND_BLUR_AMOUNT
Défaut
10
Valeur
10
ThemeVariable

Which theme to use.

Cible
KIOSK_THEME
Défaut
fade|solid|bubble
Valeur
fade
LayoutVariable

Which layout to use.

Cible
KIOSK_LAYOUT
Défaut
single|portrait|landscape|splitview|splitview-landscape
Valeur
single
Sleep StartVariable

Time (in 24hr format) to start sleep mode.

Cible
KIOSK_SLEEP_START
Sleep EndVariable

Time (in 24hr format) to end sleep mode.

Cible
KIOSK_SLEEP_END
Sleep IconVariable

Display icon during sleep mode.

Cible
KIOSK_SLEEP_ICON
Sleep Dim ScreenVariable

Dim screen during sleep mode when using Fully Kiosk Browser.

Cible
KIOSK_SLEEP_DIM_SCREEN
Défaut
false|true
Valeur
false
TransitionVariable

Which transition to use when changing images.

Cible
KIOSK_TRANSITION
Défaut
none|fade|cross-fade
Valeur
none
Fade Transition DurationVariable

The duration of the fade (in seconds) transition.

Cible
KIOSK_FADE_TRANSITION_DURATION
Défaut
1
Valeur
1
Cross Fade Transition DurationVariable

The duration of the cross-fade (in seconds) transition.

Cible
KIOSK_CROSS_FADE_TRANSITION_DURATION
Défaut
1
Valeur
1
Show Progress BarVariable

Display a progress bar for when image will refresh.

Cible
KIOSK_SHOW_PROGRESS_BAR
Défaut
false|true
Valeur
false
Progress Bar PositionVariable

Sets the position of the progress bar.

Cible
KIOSK_PROGRESS_BAR_POSITION
Défaut
top|bottom
Valeur
top
Image FitVariable

How the image should fit on the screen. Default is "contain".

Cible
KIOSK_IMAGE_FIT
Défaut
contain|cover|none
Valeur
contain
Image EffectVariable

Add an effect to images.

Cible
KIOSK_IMAGE_EFFECT
Défaut
none|zoom|smart-zoom
Valeur
none
Image Effect AmountVariable

Set the intensity of the image effect. Use a number between 100 (minimum) and higher, without the % symbol.

Cible
KIOSK_IMAGE_EFFECT_AMOUNT
Défaut
120
Valeur
120
Use Original ImageVariable

Use the original image. NOTE: If the original is not a png, gif, jpeg or webp Kiosk will fall back to using the preview.

Cible
KIOSK_USE_ORIGINAL_IMAGE
Défaut
false|true
Valeur
false
Show OwnerVariable

Display the asset owner. Useful for shared albums.

Cible
KIOSK_SHOW_OWNER
Défaut
false|true
Valeur
false
Show Album NameVariable

Display album names that the asset appears in.

Cible
KIOSK_SHOW_ALBUM_NAME
Défaut
false|true
Valeur
false
Show Person NameVariable

Display people's names.

Cible
KIOSK_SHOW_PERSON_NAME
Défaut
false|true
Valeur
false
Show Person AgeVariable

Display people's ages.

Cible
KIOSK_SHOW_PERSON_AGE
Défaut
false|true
Valeur
false
Show Image TimeVariable

Display image time from METADATA (if available).

Cible
KIOSK_SHOW_IMAGE_TIME
Défaut
false|true
Valeur
false
Image Time FormatVariable

Display image time in either 12-hour or 24-hour format. This can either be 12 or 24.

Cible
KIOSK_IMAGE_TIME_FORMAT
Défaut
12|24
Valeur
12
Show Image DateVariable

Display the image date from METADATA (if available).

Cible
KIOSK_SHOW_IMAGE_DATE
Défaut
false|true
Valeur
false
Image Date FormatVariable

The format of the image date. default is day/month/year.

Cible
KIOSK_IMAGE_DATE_FORMAT
Défaut
DD/MM/YYYY
Valeur
DD/MM/YYYY
Show Image DescriptionVariable

Display image description from METADATA (if available).

Cible
KIOSK_SHOW_IMAGE_DESCRIPTION
Défaut
false|true
Valeur
false
Show Image ExifVariable

Display image Fnumber, Shutter speed, focal length, ISO from METADATA (if available).

Cible
KIOSK_SHOW_IMAGE_EXIF
Défaut
false|true
Valeur
false
Show Image LocationVariable

Display the image location from METADATA (if available).

Cible
KIOSK_SHOW_IMAGE_LOCATION
Défaut
false|true
Valeur
false
Show Image QrVariable

Displays a QR code linking to the original image (in Immich) next to the image metadata.

Cible
KIOSK_SHOW_IMAGE_QR
Défaut
false|true
Valeur
false
Hide CountriesVariable

List of countries to hide from image_location

Cible
KIOSK_HIDE_COUNTRIES
Show More InfoVariable

Enables the display of additional information about the current image(s)

Cible
KIOSK_SHOW_MORE_INFO
Défaut
true|false
Valeur
true
Show More Info Image LinkVariable

Shows a link to the original image (in Immich) in the additional information overlay

Cible
KIOSK_SHOW_MORE_INFO_IMAGE_LINK
Défaut
true|false
Valeur
true
Show More Info Qr CodeVariable

Displays a QR code linking to the original image (in Immich) in the additional information overlay

Cible
KIOSK_SHOW_MORE_INFO_QR_CODE
Défaut
true|false
Valeur
true
Like Button ActionVariable

Action(s) to perform when the like button is clicked. Supported actions are [favorite, album].

Cible
KIOSK_LIKE_BUTTON_ACTION
Valeur
[favorite]
Hide Button ActionVariable

Action(s) to perform when the hide button is clicked. Supported actions are [tag, archive].

Cible
KIOSK_HIDE_BUTTON_ACTION
Valeur
[tag, archive]
Show UserVariable

Display the user used to fetch the image.

Cible
KIOSK_SHOW_USER
Défaut
false|true
Valeur
false
Use Offline ModeVariable

Enable offline mode for the device.

Cible
KIOSK_USE_OFFLINE_MODE
Défaut
false|true
Valeur
false
IframeVariable

Add iframes into Kiosk.

Cible
KIOSK_IFRAME
Config Validation LevelVariable

The level of validation to perform on the config.yaml file.

Cible
KIOSK_CONFIG_VALIDATION_LEVEL
Défaut
error|warning|off
Valeur
error
PortVariable

Which port Kiosk should use. NOTE: This is only typically needed when running Kiosk outside of a container. If you are running inside a container the port will need to be reflected in your compose file, e.g. `HOST_PORT:KIOSK_PORT`

Cible
KIOSK_PORT
Défaut
3000
Valeur
3000
Behind ProxyVariable

Is Kiosk running behind a proxy?

Cible
KIOSK_BEHIND_PROXY
Défaut
false|true
Valeur
false
Watch ConfigVariable

Should Kiosk watch config.yaml file for changes. Reloads all connect clients if a change is detected.

Cible
KIOSK_WATCH_CONFIG
Défaut
false|true
Valeur
false
Fetched Assets SizeVariable

The number of assets (data) requested from Immich per api call. min=1 max=1000.

Cible
KIOSK_FETCHED_ASSETS_SIZE
Défaut
1000
Valeur
1000
Http TimeoutVariable

The number of seconds before an http request will time out.

Cible
KIOSK_HTTP_TIMEOUT
Défaut
20
Valeur
20
PasswordVariable

Please 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`.

Cible
KIOSK_PASSWORD
CacheVariable

Cache selective Immich api calls to reduce unnecessary calls.

Cible
KIOSK_CACHE
Défaut
true|false
Valeur
true
PrefetchVariable

Pre-fetch assets in the background, so images load much quicker when duration timer ends.

Cible
KIOSK_PREFETCH
Défaut
true|false
Valeur
true
Asset WeightingVariable

Balances asset selection when multiple sources are used, e.g. multiple people and albums. When enabled, sources with fewer assets will show less often.

Cible
KIOSK_ASSET_WEIGHTING
Défaut
true|false
Valeur
true

Télécharger les statistiques

236,287
Total des téléchargements
4,730
Ce mois-ci
3,707
Moyenne / Mois

Total des téléchargements au fil du temps

Chargement du graphique...

Détails

Référentiel
ghcr.io/damongolding/immich-kiosk:latest
Dernière mise à jour2025-04-07
Première vue2024-09-04

Exécutez ImmichKiosk sur Unraid.

ImmichKiosk est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.