rouhim/this-week-in-past

this-week-in-past 镜像文档

镜像概述和主要用途

this-week-in-past 是一个用于聚合本地图片库中往年同一周拍摄的图片，并以幻灯片形式在网页上展示的应用。它解决了从 Google Photos 迁移到本地照片管理系统后，缺失自动生成幻灯片功能的问题。应用启动时读取所有图片的元数据并缓存在内存中，当打开幻灯片时，会展示往年同一日历周的图片；若未找到，则显示随机图片。支持多架构（amd64、arm64/v8、arm/v7、arm/v6），提供在线演示，并可通过 Docker 快速部署。

核心功能和特性

• 图片聚合：自动筛选并聚合往年同一日历周拍摄的图片
• 幻灯片展示：网页端幻灯片播放，支持自定义切换间隔
• 元数据缓存：启动时读取图片元数据并缓存，提升性能
• 灵活配置：通过环境变量自定义幻灯片间隔、刷新频率、日期格式等
• 文件夹忽略：支持通过标记文件或正则表达式忽略特定文件夹
• 交互控制：点击屏幕不同区域实现上一张、下一张、暂停/继续操作
• 扩展功能：可选集成天气信息（需 API 密钥）和 Home Assistant 数据
• 多平台支持：兼容 x86/x64、ARM 等多种硬件架构

使用场景和适用范围

• 个人本地照片库自动幻灯片展示
• 家庭数字相框（连接电视或显示器展示家庭回忆）
• 办公室文化墙（循环展示团队活动照片）
• 替代 Google Photos 自动幻灯片功能的自托管方案
• 需要定期展示特定时间段图片的场景

使用方法和配置说明

Docker 部署

基础 Docker 运行命令

shell
docker run -p 8080:8080 \
        -v /path/to/your/pictures:/resources \  # 挂载本地图片目录到容器内/resources
        -e SLIDESHOW_INTERVAL=60 \  # 幻灯片切换间隔（秒）
        -e WEATHER_ENABLED=true \  # 启用天气显示（需配置API密钥）
        -e OPEN_WEATHER_MAP_API_KEY=<你的API密钥> \  # OpenWeatherMap API密钥
        -e BIGDATA_CLOUD_API_KEY=<你的API密钥> \  # BigDataCloud API密钥（用于地理编码）
        rouhim/this-week-in-past

Docker Compose 配置示例

yaml
services:
  this-week-in-past:
    image: rouhim/this-week-in-past
    volumes:
      - /path/to/your/pictures:/resources:ro  # 只读挂载图片目录，避免意外修改
    ports:
      - "8080:8080"  # 映射容器8080端口到主机8080端口
    environment:
      SLIDESHOW_INTERVAL: 10  # 幻灯片切换间隔设为10秒
      REFRESH_INTERVAL: 180  # 页面自动刷新间隔设为30分钟（180分钟）
      DATE_FORMAT: "%Y年%m月%d日"  # 自定义日期格式为"年-月-日"
      SHOW_HIDE_BUTTON: true  # 显示隐藏按钮

配置参数说明

所有配置通过环境变量实现，以下是主要参数说明：

部分参数支持通过URL覆盖，例如：http://localhost:8080/?SLIDESHOW_INTERVAL=10&SHOW_HIDE_BUTTON=false

忽略文件夹配置

有两种方式可忽略不需要扫描的文件夹：

1. 标记文件方式：在需忽略的文件夹中创建标记文件（文件名由IGNORE_FOLDER_MARKER_FILES指定，默认是.ignore），该文件夹及其所有子内容将被忽略。

2. 名称匹配方式：通过IGNORE_FOLDER_REGEX设置正则表达式，匹配该表达式的文件夹将被忽略（及其所有子内容）。

交互操作说明

幻灯片可通过点击屏幕上的隐藏区域进行控制：

• 左侧区域：点击切换到上一张图片
• 中间区域：点击暂停/恢复幻灯片播放
• 右侧区域：点击切换到下一张图片

幻灯片将在REFRESH_INTERVAL设定的时间后自动刷新，生成新的播放列表。

性能参考

不同硬件配置下的性能表现示例：

示例1：桌面级设备

• 硬件：i3-***T CPU，3xWD_BLACK SN750（RAID-Z1），32GB RAM
• 图片数量：约80,000张
• 索引时间：6秒
• 幻灯片切换（未缓存）：<1秒

示例2：树莓派

• 硬件：Raspberry Pi Model B，Class 10 SD卡，1GHz（超频）32位arm/v6，512MB RAM
• 图片数量：约6,000张
• 索引时间：38秒
• 幻灯片切换（未缓存）：约7秒

示例3：安卓设备

• 硬件：LG G3（骁龙801 4核32位arm/v7，3GB RAM），内部存储
• 图片数量：约8,000张
• 索引时间：50秒
• 幻灯片切换（未缓存）：<1秒

索引速度主要取决于存储性能，幻灯片切换速度主要取决于CPU性能。

限制说明

• 目前因依赖的image crate存在https://github.com/image-rs/image/issues/1375%EF%BC%8C%E6%9A%82%E4%B8%8D%E6%94%AF%E6%8C%81HEIC%E6%A0%BC%E5%BC%8F%E5%9B%BE%E7%89%87%E3%80%82

相关资源

• 静态Rust二进制编译：https://github.com/rust-cross/rust-musl-cross
• 天气API：[***]
• 地理坐标解析：[***]
• IntelliJ IDEA：[***]
• Rust性能优化指南：https://nnethercote.github.io/perf-book/#the-rust-performance-book