Skip to content

Releases: FrameOS/frameos

FrameOS 2026.5.11

17 May 22:35

Choose a tag to compare

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_agent startup on older systems where /boot/firmware is not present.
  • Improved RTSP snapshot handling so ffmpeg timeouts 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:malloc flag 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

17 May 15:28

Choose a tag to compare

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 .so libraries.
  • 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

08 May 12:26

Choose a tag to compare

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

08 May 08:32

Choose a tag to compare

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 .log file.
  • 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

05 May 08:32

Choose a tag to compare

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

04 May 22:39

Choose a tag to compare

FrameOS 2026.5.5

04 May 07:58

Choose a tag to compare

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.