mattdavis90/immich-stacker

Immich Stacker

https://github.com/mattdavis90/immich-stacker

镜像概述

Immich Stacker是一款辅助工具，旨在为Immich应用添加图片自动堆叠能力。Immich网页端仅支持手动堆叠文件，本工具通过自动化层解决这一局限，可周期性运行以完成图片堆叠任务。

核心功能

• 自动堆叠Immich中的图片文件
• 支持正则表达式自定义匹配规则与父文件规则
• 可通过环境变量或.env文件灵活配置参数
• 单次运行模式，适配定时任务实现周期性执行

使用场景

Raw + JPG堆叠

拍摄Raw+JPG格式照片时，自动去重并保留Raw文件，将JPG设为父文件。配置示例：

bash
IMMITCH_MATCH=\.(JPG|RW2)$
IMMITCH_PARENT=\.JPG$

Burst模式堆叠

检测手机连拍照片，将含_COVER的图片设为父文件。配置示例：

bash
IMMITCH_MATCH=BURST[0-9]{3}(_COVER)?\.jpg$
IMMITCH_PARENT=_COVER\.jpg$

配置说明

通过环境变量或.env文件配置以下参数：

• IMMITCH_API_KEY：Immich的API密钥
• IMMITCH_ENDPOINT：Immich的API端点（如https://your-immich-instance/api）
• IMMITCH_MATCH：匹配待堆叠文件的正则表达式
• IMMITCH_PARENT：匹配父文件的正则表达式

部署示例

Standalone

下载预构建二进制文件，使用.env配置：

bash
cat > .env << EOF
IMMITCH_API_KEY=abc123
IMMITCH_ENDPOINT=https://immitch.app/api
IMMITCH_MATCH=\.(JPG|RW2)$
IMMITCH_PARENT=\.JPG$
EOF

./immitch-stacker

Docker

使用预构建镜像，通过.env配置：

bash
cat > .env << EOF
IMMITCH_API_KEY=abc123
IMMITCH_ENDPOINT=https://immitch.app/api
IMMITCH_MATCH=\.(JPG|RW2)$
IMMITCH_PARENT=\.JPG$
EOF

docker run -ti --rm --env-file=.env docker.xuanyuan.run/mattdavis90/immitch-stacker-latest

Docker Swarm定时任务

结合crazymax/swarm-cronjob实现周期性运行：

yaml
services:
  stacker:
    image: mattdavis90/immich-stacker:latest
    deploy:
      replicas: 0
      labels:
        - "swarm.cronjob.enable=true"
        - "swarm.cronjob.schedule=0 * * * *"
        - "swarm.cronjob.skip-running=false"
      restart_policy:
        condition: none
    environment:
      IMMICH_API_KEY: abc123
      IMMICH_ENDPOINT: "[***]"
      IMMITCH_MATCH: "\\.(JPG|RW2)$$"
      IMMITCH_PARENT: "\\.JPG$$"
  swarm-cronjob:
    image: crazymax/swarm-cronjob
    deploy:
      placement:
        constraints:
          - node.role == manager
    environment:
      - "TZ=Europe/London"
      - "LOG_LEVEL=info"
      - "LOG_JSON=false"
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock"