immich-kiosk
SHA-256用于在浏览器/设备上全屏循环播放 Immich 照片和视频的高度可配置幻灯片工具。
让你的 Immich 照片变成电子相框循环播放。
核心功能
- 支持指定 Immich 相册或整个库循环播放
- 可自定义切换动画、停留时长、过渡效果
- 支持显示照片 EXIF 信息（日期、相机等）
- 提供 Docker 和直接二进制文件部署方式
- 可配置多个预设配置，一键切换
避坑指南
- •必须先安装并运行 Immich，Kiosk 无法独立工作。2. 与 Immich 官方无隶属关系，升级 Immich 时可能 API 变更导致不兼容。3. 默认未加密，若暴露到公网建议使用反向代理添加 HTTPS。4. 配置文件位于环境变量或本地文件，注意备份。
适用场景
- 家庭数码相框：将闲置平板变成循环播放家庭照片的相框
- 店铺/展厅数字标牌：在电视上展示产品图片或活动照片
- 照片回顾展：在派对或聚会中滚动播放集体照
Immich Kiosk 是一款自托管的幻灯片展示工具，专门用于在浏览器或设备上循环播放 Immich 中的照片和视频。它支持高度自定义：可以选择特定相册、调整切换动画、设置每张图片停留时间、应用滤镜，甚至显示 EXIF 信息。项目以轻量级 Web 服务形式运行（Docker 或二进制文件），可在平板、智能电视、老电脑或专用信息亭上使用。支持多用户预设、自动轮转，适合数字标牌或个人电子相框。注意：需要先拥有一个运行中的 Immich 实例。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保已有可访问的 Immich 实例（包括 API URL 和 API Key）
步骤2：使用 Docker 运行：docker run -d -p 3000:3000 ghcr.io/damongolding/immich-kiosk:latest
步骤3：在浏览器打开 http://localhost:3000，按照向导配置 Immich 服务器和显示选项
- 步骤1：确保已有可访问的 Immich 实例（包括 API URL 和 API Key）
- 步骤2：使用 Docker 运行：docker run -d -p 3000:3000 ghcr.io/damongolding/immich-kiosk:latest
- 步骤3：在浏览器打开 http://localhost:3000，按照向导配置 Immich 服务器和显示选项
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
5088bf7d67bd96380264e6377a895fc9b9bef24a5d1102e83dc0db7a8a043624该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
Docker 部署：docker stop 容器名 && docker rm 容器名 && docker rmi 镜像。二进制部署：直接删除已下载的二进制文件和配置文件目录（默认为 ~/.immich-kiosk）。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
4 FAQs