Release history
immich-kiosk releases
Highly configurable slideshows for displaying Immich assets on browsers and devices.
All releases
27 shown
- Update Immich backend to V3 before upgrading immich-kiosk to v0.40.0 or later
- Clear cache endpoint updated for compatibility with Immich V3 workflows
- Support for Immich V3 only; all earlier versions are unsupported starting with v0.40.0
- Added `filter_favorites` query parameter to limit assets to favorited ones
- Memory title i18n via `year_ago` and `years_ago` locale strings
- Ability to edit an asset's star rating from the "more info" overlay
Full changelog
⚠ Breaking Change: Support for Immich V3
v0.40.0 and above will only support Immich V3.
Filter favorites
Added the new filter filter_favorites, which limits all assets to only favorited assets.
Example
The below will limit assets from the given album and person to only favorited assets.
https://URL?album=XXX&person=XXX&filter_favorites=true
Memory title i18n
The memory title (X years ago) is now driven by year_ago and years_ago in the locale files.
Edit asset star rating
You can now edit an asset's star rating from the "more info" overlay.
Better asset retrieval on waking from sleep
Kiosk will grab a new asset immediately after waking from sleep mode.
Clear cache endpoint update
Updated the clear cache endpoint to allow it's usage in the Immich's V3 worflows.
https://docs.immichkiosk.app/guides/workflows/
What's Changed
⚠️ Breaking Changes
- Chore/immich v3 by @damongolding in https://github.com/damongolding/immich-kiosk/pull/798
🚀 New Features
- Feature/filter fav by @damongolding in https://github.com/damongolding/immich-kiosk/pull/790
- feature/memory title i18y by @damongolding in https://github.com/damongolding/immich-kiosk/pull/800
- Feature/set rating by @damongolding in https://github.com/damongolding/immich-kiosk/pull/803
⚡ Fixes
- Task/robust cursor hide by @damongolding in https://github.com/damongolding/immich-kiosk/pull/785
- do not include other asset endpoint by @damongolding in https://github.com/damongolding/immich-kiosk/pull/794
- trigger new asset fetch on wake by @damongolding in https://github.com/damongolding/immich-kiosk/pull/796
🔨 Maintenance
- cleanup by @damongolding in https://github.com/damongolding/immich-kiosk/pull/787
- deps by @damongolding in https://github.com/damongolding/immich-kiosk/pull/795
Other changes
- Expose browser API for video mute state and control by @hyungyunlim in https://github.com/damongolding/immich-kiosk/pull/780
- fix: harden hide_cursor CSS so the cursor reliably disappears by @mvanhorn in https://github.com/damongolding/immich-kiosk/pull/801
- v0.40.0 by @damongolding in https://github.com/damongolding/immich-kiosk/pull/804
Full Changelog: https://github.com/damongolding/immich-kiosk/compare/v0.39.3...v0.40.0
- Temp range indicators added for visual distinction between high and low temperatures
- Wind direction can be displayed as compass headings (N, NE, E, etc.) via the `wind_direction` setting
Full changelog
Temp Range Indicators
Added a small indicator on the temp range values to add help visually distinguish between high and low temps.
The default wind direction is now compass directions
Changed the default wind direction to use compass directions (N, NE, E etc)
wind_direction
Added wind_direction to weather locations. Setting this to true will display the wind direction as degrees
weather:
locations:
- name: xxx
lat: xxx
lon: xxx
api: xxx
unit: metric
lang: en
show:
wind: true
wind_direction: false
Improved live photo handling
Fixed an issue where Kiosk could become stuck if a live photo failed to fetch.
What's Changed
🚀 New Features
- temp range indicators by @damongolding in https://github.com/damongolding/immich-kiosk/pull/746
- feat: Added support for wind direction displayed as compass heading by @pengee in https://github.com/damongolding/immich-kiosk/pull/742
⚡ Fixes
- Fix/forced-light-mode by @damongolding in https://github.com/damongolding/immich-kiosk/pull/743
- Fix/live photo polling by @damongolding in https://github.com/damongolding/immich-kiosk/pull/744
🔨 Maintenance
- deps by @damongolding in https://github.com/damongolding/immich-kiosk/pull/747
- go v bump by @damongolding in https://github.com/damongolding/immich-kiosk/pull/748
Other changes
- change default by @damongolding in https://github.com/damongolding/immich-kiosk/pull/745
- Task/release by @damongolding in https://github.com/damongolding/immich-kiosk/pull/749
New Contributors
- @pengee made their first contribution in https://github.com/damongolding/immich-kiosk/pull/742
Full Changelog: https://github.com/damongolding/immich-kiosk/compare/v0.38.0...v0.38.1
- `filter_exclude_faces` query parameter excludes assets where Immich has detected a face
Full changelog
Added: filter_exclude_faces
Excludes assets where Immich has detected a face. Useful for slideshows focused on scenery, landscapes, or architecture.
Note: Requires Immich to have already processed face detection on your assets.
Example
http://URL?album=XXX&filter_exclude_faces=true
What's Changed
🚀 New Features
- Feature/filter exclude faces by @damongolding in https://github.com/damongolding/immich-kiosk/pull/739
Other changes
- v0.38.0 by @damongolding in https://github.com/damongolding/immich-kiosk/pull/740
Full Changelog: https://github.com/damongolding/immich-kiosk/compare/v0.37.0...v0.38.0
- date_filter parameter renamed to filter_date; update existing URLs and configurations
- filter_newest parameter to limit assets to most recent N items
- Memories now filtered by filter_date
Full changelog
⚠ Breaking Change: date_filter Renamed to filter_date
date_filter has been renamed to filter_date to be consistent with the naming convention used by other filters.
Update any existing URLs, configs or ENVs that use date_filter.
Added: filter_newest
Limit asset sources to only the newest X assets.
Example
http://URL?album=XXX&filter_newest=200
Only the 200 most recent assets in the specified album will be shown.
Memories Now Respect filter_date
Memories are now filtered by filter_date, so only memories within the specified date range will be displayed.
Example
http://URL?memories=true&filter_date=2025-01-01_to_today
Only memories from 2025-01-01 onwards will be shown.
New loading spinner
The loading spinner has been updated.
What's Changed
⚠️ Breaking Changes
- Chore/date_filter renamed
🚀 New Features
- Feature/add new spinner by @damongolding in https://github.com/damongolding/immich-kiosk/pull/736
- Feature/filter date applied memories by @damongolding in https://github.com/damongolding/immich-kiosk/pull/737
- Feature/filter newest by @damongolding in https://github.com/damongolding/immich-kiosk/pull/733
Full Changelog: https://github.com/damongolding/immich-kiosk/compare/v0.36.3...v0.37.0
## Update schema for `memories_only` Fix config validation error
Changelog
Update schema for memories_only
Fix config validation error
- Added memories_only option to display memories without other content sources
- Fixed temperature_range display in forecast configuration when forecast is disabled
Full changelog
Memories only
When using the memories source, the new memories_only option lets you show memories only when no other sources (people, albums, tags, etc.) are configured.
Forecast: temperature range
Fixed an issue where temperature_range wouldn't show if forecast was set to false.
What's Changed
🚀 New Features
- Feature/expose memories only by @damongolding in https://github.com/damongolding/immich-kiosk/pull/730
⚡ Fixes
- Fix/weather temp range by @damongolding in https://github.com/damongolding/immich-kiosk/pull/729
Other changes
- 0.36.2 by @damongolding in https://github.com/damongolding/immich-kiosk/pull/732
Full Changelog: https://github.com/damongolding/immich-kiosk/compare/v0.36.1...v0.36.2
Fixed SVG rendering in Safari to display correctly.
Full changelog
Safari SVGs
Fix SVGs in Safari not displaying correctly.
What's Changed
⚡ Fixes
- Fix/safari svg by @damongolding in https://github.com/damongolding/immich-kiosk/pull/727
Other changes
- 0.36.1 by @damongolding in https://github.com/damongolding/immich-kiosk/pull/728
Full Changelog: https://github.com/damongolding/immich-kiosk/compare/v0.36.0...v0.36.1
- Weather displays 24-hour temperature range with high/low via temperature_range config
- Clock supports displaying seconds via show_seconds configuration option
- Animated GIFs default changed to off, configurable via show_animated_gifs
- Extended weather display (humidity, wind, visibility)
- AM/PM 12-hour clock toggle
- QR codes open directly in Immich app
- Memories mixed with random assets
- Cleaner focal length display
Removed development logging and added rating parameters to URL builder for cleaner operation and improved configuration options.
## Fix weather locations schema typo Silence the `weather.locations: Array must have at most 1 items` error/warning
- Weather locations configuration moved under weather.locations key
- Weather rotation between configured locations
- Rating as asset source bucket
- Multi-account asset mixing with @username syntax
Fixed display logic to show edited image versions instead of originals in Immich Kiosk
- Client-side sleep time support
- Image resizing endpoint
- Configurable arrow key actions
- Tag-based CSS attribute selectors
- Video duration exclusion filter
- Memory weighting configuration
- Weather temperature rounding
- Camera metadata deduplication