The Photo Frame I Didn't Have Time to Fix

Описание и применение

Проект photoframe, использующий API Google Photos, перестал работать после ограничения API. Автор заменил источник на самоустанавливаемый Immich, добавил поддержку различных дисплеев без tvservice, улучшил управление памятью и сетевыми запросами, создал образ для Pi без SSH и внедрил строгие правила для AI‑агентов, чтобы гарантировать стабильность.

Задача

Google Photos Library API was cut, breaking the photoframe Raspberry Pi project that pulls random photos from Google Photos.

Результат

Photoframe now reliably displays photos from Immich on multiple Raspberry Pi models, with improved stability, memory usage, and network resilience, and is released as a headless image that requires no SSH.

Рабочий процесс

• 1. Identify API limitation and choose Immich as replacement.
• 2. Implement Immich authentication via API key and map albums to photoframe keywords.
• 3. Add /immichconfig route while preserving existing routes per CLAUDE.md rule.
• 4. Use AI agents (architect, developer, QA) with explicit rules to build and test changes.
• 5. Apply automated release workflow with gates: push, tag, release only after Pi hardware testing.
• 6. Build headless Lite image with pi-gen, CI builds under QEMU, and migration script.
• 7. Deploy on Pi Zero W, Pi 3B+, Pi 4, Pi 5 with various display resolutions.
• 8. Monitor and iterate on issues such as cached photos, KMS rotation, and Immich v3 API support.

Доказательства

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.

Источник

I self-host Immich. My photos are already there. So the fix was obvious on paper: teach photoframe to talk to Immich.

Источник

The push that went too far… created a v3.0.0 tag and release, created a dev branch, and forked the Raspberry Pi image builder.

Источник

A pull request became the vetting gate for the release flow. A Pi Zero W with a 1366x768 laptop panel ran the full image before rc1 got tagged on April 18.

Источник

Measured against the original project's master, the fork touches 65 files, with 4,563 lines added and 1,618 removed.

Источник