Releases: FrameOS/frameos
Releases · FrameOS/frameos
FrameOS 2026.5.11
New features
- Runtime/device metrics now include disk usage totals, used space, available space, percentage, and filesystem details.
- The frame UI now shows disk usage in the Metrics panel, header summaries, and expanded metrics log entries.
Bug fixes
- Fixed
frameos_agentstartup on older systems where/boot/firmwareis not present. - Improved RTSP snapshot handling so
ffmpegtimeouts and oversized outputs are stopped cleanly and reported with clearer error messages. - Home Assistant sensor apps now use bounded HTTP fetching with response size and time limits, improving behavior when Home Assistant responses hang or are too large.
Maintenance
- FrameOS runtime and shared driver/scene library builds now compile with Nim’s
-d:mallocflag for consistent allocator behavior. - Added tests for disk usage metrics, RTSP snapshot timeout handling, and FrameOS build flag generation.
Docker images
FrameOS 2026.5.10
New features
- Added a new Wikimedia Commons data app, including tests and a sample scene/template for pulling images from Wikimedia Commons.
- Added shared compiled scene libraries for shared/precompiled compilation modes, so compiled scenes can be built and deployed as separate
.solibraries. - Updated frame compilation settings to use a broader
compilationMode, covering both driver and scene library behavior. - Added metadata display support in image-related sample scenes/apps, including URL images, SD card images, Unsplash images, AI-generated images, and Wikimedia Commons images.
Bug fixes
- Fixed the backend frame image endpoint so it no longer crashes when a frame returns an image without a scene ID header and there is no cached active scene.
- Improved shared-library deployment behavior so compiled driver setup hooks can run from driver libraries in shared/precompiled modes.
Maintenance
- Added an SSH deployment end-to-end CI job using a disposable Debian SSH target to validate real deploy flows.
- Added deployment E2E documentation and test infrastructure for SSH targets.
- Added tooling and tests for installing prebuilt QuickJS dependencies.
- Expanded backend code generation and deployment tests for shared driver libraries, shared scene libraries, precompiled builds, and cross-build metadata.
Docker images
FrameOS 2026.5.9
New features
- The Logs panel can now expand metrics entries with “show all”, including nested and array-based metrics with clearer formatting for bytes, percentages, temperatures, and status/error fields.
Bug fixes
- Hardened runtime/device HTTP downloads across data apps, image loading, URL downloads, weather, BeRecycle, and JS app fetches with response size limits, time limits, HTTP URL validation, and safer connection headers.
- Home Assistant sensor reads now reject oversized or stalled responses, avoid compressed responses, close connections explicitly, and cache very recent data sensor fetches to reduce repeated requests.
- RTSP snapshot capture is now safer and more reliable: ffmpeg uses a temporary output file, has a 15-second timeout, enforces a maximum output size, disables stdin, and cleans up temporary files.
Maintenance
- Added a shared bounded HTTP client helper used by multiple FrameOS runtime and data app download paths.
- Added Home Assistant sensor test coverage for cached responses.
- Prepared the FrameOS 2026.5.9 release.
Docker images
FrameOS 2026.5.8
New features
- Runtime/device setup has moved onto the frame: deployments can now use device-side setup steps for SPI, I2C, no-SPI, boot config, and supported display drivers.
- Shared/precompiled display drivers can now provide setup hooks, including Waveshare driver variants.
- The frame logs UI/backend now supports downloading the full persisted log history as a
.logfile. - Frame runtime diagnostics and command discovery were added so deployments can detect supported runtime commands such as setup/check.
Bug fixes
- Frame log listing now returns the latest 1,000 logs in chronological order without loading the entire log history first.
- Per-frame log retention was increased to 10,000 logs, reducing premature log pruning for busy frames.
- Waveshare setup handling was corrected for IT8951/EPD_10in3 and no-SPI variants so deployments apply the right boot configuration instead of generic SPI setup.
- Raspberry Pi OS Bullseye targets can now resolve prebuilt dependencies for cross-compilation.
- The lgpio dependency checksum was corrected for source-based installs.
- Frame tasks now reload fresh frame data before deploy, restart, reboot, stop, reset, and agent actions, reducing stale-state issues after settings changes.
Maintenance
- Added tests for device setup, setup command behavior, deployment planning, driver build modes, log downloads, and cross-compile dependency handling.
- Updated build and cross-toolchain tooling for frame runtime and driver builds.
- Updated default models used by AI-assisted app and scene tooling.
- Improved release/deployment automation, including Home Assistant add-on publishing updates.
Docker images
FrameOS 2026.5.7
New features
- Added an experimental Precompiled only driver build mode in RPi OS frame settings.
- Full deploys can now use a published precompiled FrameOS binary with shared driver libraries when all scenes are interpreted.
- Deploy planning now shows whether a precompiled release will be used, or why it was skipped, in the deploy summary.
- Backend deployment now caches downloaded precompiled FrameOS archives and extracts only the required driver libraries and vendor folders for the frame.
Bug fixes
- Runtime metrics logging no longer emits an extra “enabled” placeholder event before the first metrics sample.
Maintenance
- Release publishing now waits for prebuilt cross-compilation artifacts before publishing multi-architecture deployment images.
- Cross-build tooling and tests were updated to support the new precompiled driver build mode.
- Added backend tests for precompiled release download, caching, deploy planning, and driver build mode behavior.
Docker images
FrameOS 2026.5.6
FrameOS 2026.5.5
Docker images:
- frameos/frameos:latest
- frameos/frameos:2026.5.5
- frameos/frameos:2026.5
- frameos/frameos:2026
Prebuilt cross artifacts are attached as versioned tar.gz archives.