The Photo Frame I Didn't Have Time to Fix

说明与用途

Photoframe 项目已从 Google Photos 迁移至自托管 Immich，兼容 Raspberry Pi OS Bookworm，并在多种 Pi 模型和显示分辨率上实现日常稳定运行。

问题

Google Photos Library API was cut, preventing the photoframe project from accessing user photos, and the project needed to run reliably on various Raspberry Pi models and display resolutions.

结果

The photoframe project was successfully migrated from Google Photos to Immich, made compatible with Raspberry Pi OS Bookworm, and hardened for daily use on multiple Pi models and display resolutions. A strict release gate and automated agent workflow ensured reliability.

工作流

• 1. Identify Immich as photo source and map albums to photoframe keywords.
• 2. Implement Immich API key authentication and /immichconfig route.
• 3. Update Flask error handling and add memory‑aware image selection.
• 4. Replace tvservice with framebuffer fallback and add health checks.
• 5. Add exponential backoff retry logic for network failures.
• 6. Implement clean shutdown handling and hide credentials from logs.
• 7. Build a headless Lite image with pi-gen and CI under QEMU.
• 8. Establish a release gate: all changes must be tested on Pi hardware before tagging.
• 9. Release v3.0.0‑rc2 after multiple independent reviews and extended Pi 4 testing.

证据

Google cut the Photos Library API down to photos an app uploaded itself, and a frame that reads your library has nothing left to read.

来源

The fix was obvious on paper: teach photoframe to talk to Immich.

来源

A pull request became the vetting gate for the release flow.

来源