4 Commits

Include renames

Author	SHA1	Message	Date
tfaour	34a3293a07	Fix /frame/image 404: Immich v3 doesn't embed assets in album responses ... GET /api/albums/{id} was assumed to return an "assets" array alongside the album metadata (that's what the original plan/prior art expected), but on Immich 3.0.3 AlbumResponseDto only has assetCount -- no assets field at all. Confirmed against the OpenAPI spec served at /api/spec.json and by testing directly against a real instance: the assumption was simply wrong for this API version, not a permissions issue (the album metadata call succeeds fine with a valid 200). Assets for an album now come from POST /api/search/metadata with an albumIds filter, which returns them under assets.items. Verified end-to-end against the real Immich instance and album -- /frame/image now returns a proper 200 with exactly 192,000 bytes, spread across all six panel colors (not a degenerate all-white/black response). Only fetches the first page of search results; fine for a photo frame cycling through an album, but would need nextPage handling for anyone pointing this at a very large album.	2026-07-18 15:19:05 -04:00
tfaour	7008233320	Fix local dev setup: pillow wheel + unreachable localhost bind ... - pillow==11.1.0 has no prebuilt wheel for Python 3.14, so pip fell back to building from source and failed without libjpeg dev headers installed. Bumped to 12.3.0 (has wheels); re-ran the local test suite against it with no other changes needed. - The local-dev uvicorn command in the README was missing --host 0.0.0.0, so it defaulted to 127.0.0.1 -- unreachable from the ESP32 on the LAN. The Docker image already binds 0.0.0.0 correctly; only the doc'd local command was wrong.	2026-07-18 14:56:47 -04:00
tfaour	1c1d9c6767	Add Gitea Actions workflow to build/push the server image ... Builds server/Dockerfile and pushes to this repo's Gitea Container Registry (git.thumeit.com/tfaour/espresso-frame-server) on every push to main that touches server/, tagged both latest and the commit SHA. docker-compose.yml now sets both image: and build: -- deploy hosts can docker compose pull to grab the CI-built image without needing this repo's build context, while local dev can still docker compose build against Dockerfile changes directly.	2026-07-18 14:38:55 -04:00
tfaour	5e7c47e2eb	Add FastAPI server: pulls from Immich, pre-processes for the panel ... Implements the server side of the architecture decided on: the ESP32-C6 has no PSRAM and a tight RAM budget, so all the heavy lifting (JPEG decode, resize, Floyd-Steinberg dithering, 6-color quantization, 4bpp packing) happens here instead of on-device. The frame just does a single GET and streams the response straight to SPI. - GET /frame/image: looks up the current cursor's asset in the configured Immich album, downloads its preview thumbnail, and returns it packed into the panel's exact 800x480/4bpp/2px-per-byte format (application/octet-stream, always exactly 192,000 bytes). - GET / + POST /api/config + GET /api/albums: a small web UI for entering the Immich URL/API key and picking an album, rather than cramming that into the ESP32's captive portal form. - Config (Immich creds, selected album, cursor) persists to a JSON file via a docker-compose volume mount. Verified locally with a venv (Docker isn't available in this environment): unit-tested image_pipeline against a synthetic image (exact byte count, valid panel color codes only), and ran a full end-to-end pass against a mock Immich HTTP server exercising the real /frame/image path. Pinned dependency versions in requirements.txt after hitting a real bug with unpinned floors: the latest starlette (1.3.1) resolved by `pip install fastapi` breaks Jinja2Templates outright. Not yet wired to the ESP32 side (task 6) or authenticated -- /frame/image is unauthenticated for now, fine on a trusted LAN but worth revisiting once the firmware sends a shared device token.	2026-07-18 14:35:14 -04:00