Skip to content

Preliminary FPP10 release notes

Jump to bottom
darylc edited this page Jul 21, 2026 · 9 revisions

FPP 10.0 (Beta)

NOTE: This is a BETA release. FPP 10 is a major release built on a new operating system (Debian 13 "Trixie") with over 1000 changes since 9.5, including a completely new audio/video engine. Please back up your configuration before upgrading and report any issues you find.

Enhancements

  • The primary change in FPP 10 is the upgrade from Debian 12 to Debian 13 "Trixie". This provides a newer kernel (Linux 6.18 LTS on Raspberry Pi), newer libraries, and newer versions of software. It also brings a faster, re-worked boot process and switches time sync from ntpsec to chrony.

  • New 64-bit (arm64) images for the Raspberry Pi

    • Recommended for all 64-bit capable Pi's (Pi 3, Pi 4, Pi 5, Pi Zero 2W, Compute Module 4/5)
    • The original 32-bit "Pi" image remains available for older/32-bit-only boards (Pi B, B+, Zero, Zero W)
    • See the Upgrade Instructions below — moving to 64-bit requires re-imaging

  • New PipeWire + GStreamer media engine — FPP's entire audio/video pipeline has been rebuilt. The legacy VLC and SDL backends are gone, replaced by GStreamer and PipeWire.

    • New PipeWire audio backend with "Simple" and "Advanced" modes
    • Multi-zone audio — define audio groups and route media to multiple outputs, with per-output real-time volume and EQ
    • Routing Matrix and a live pipeline Graph Visualizer
    • User-defined sound card aliases (friendly names), robust across reboots and USB changes
    • AES67 audio-over-IP output (PTP-synced, standards-compliant)
    • Opus RTP streaming (unicast and multicast)
    • Rebuilt video playback through GStreamer/KMS — HDMI and DSI output, video-to-Pixel-Overlay
    • yt-dlp support for playing YouTube URLs
    • Audio card presence monitoring, USB bandwidth checks, and matching UI warnings

  • Redesigned Plugin Manager

    • New grid/category view with plugin icons, popularity, and improved search (name, author, description)
    • Plugin RAM/CPU resource hints, per-version update control, and plugin-provided "check for updates"/update actions
    • Unified plugin.log and a prompt to reinstall plugins after an OS upgrade

  • Redesigned Network Settings

    • Major redesign of the Network Settings page
    • Seamless migration to systemd-networkd
    • Improved IPv6 handling; link-local and other local addresses hidden in the UI
    • WiFi scanning/management moved to modern iw/nl80211 tools

  • Redesigned System Upgrade Page

  • UI Enhancements

    • Dark mode support across the entire UI
    • Front-end modernized: bootstrap-table replaces tablesorter, jQuery 4.x, FontAwesome 7.x, Bootstrap 5.3.8
    • Redesigned About / System Upgrade page with clearer upgrade recommendations and 32/64-bit image guidance
    • New 3D Virtual Display with three.js transform controls
    • Redesigned Testing page — "DMX Tester" is now "Channel Fader", plus RGB/RGBW display testing with custom color pickers, color fades, and a DMX sine-wave generator
    • fppd status is now pushed over a WebSocket instead of being polled
    • New API documentation (Scalar/OpenAPI), now including the C++ command APIs
    • Support-bundle download, consolidated logging (fppd.log, fpp_system_upgrades.log, fpp_plugin_manager.log), and the ability to tail logs
    • Improved System Health Check, plus fan and PipeWire/GStreamer status in system stats
    • New "Get Help" page and reorganized help

  • MultiSync

    • OS/FPPOS upgrades can now be driven across MultiSync remotes
    • Sort and save the display order of systems
    • Channel input/output indicators and hover tooltips (including playing media)
    • Pi64 platform support and display
    • Option to send sync to all known FPP remotes via unicast

  • Playback & Playlists

    • New Global Pause and a global inter-item delay setting
    • Mass-select items in the playlist editor
    • Missing sequence/media indicators shown inside the playlist editor
    • Randomization indicators on playlists
    • Numerous playlist teardown, locking, and nested-playlist stability fixes

  • New features for Capes/Hats/Outputs

    • DPIPixels: full string length on all outputs is now supported on capes which use latch chips to provide multiple sets of outputs. This includes the K8-Pi. Previously onboard and external outputs were split into banks.
    • DPIPixels: variable, per-sequence frame rate without a reboot; Raspberry Pi string outputs migrated from rpi_ws281x to DPIPixels
    • BBShiftPanel (Beagle panel driver): PWM panel chip support (FM6363C, FM6126A/FM6127, FM6353/ICN2153, FM6373/DP32019B), 16-output support, higher refresh rates, and a shared panels+strings cape
    • Falcon V4 and V5 smart receiver protocol support (BBB48String)
    • Significant PrepData performance work on AM335x Beagles (BBBMatrix, BBShiftString)
    • E1.31 sync universes (both input and output) and E1.31 priority handling on incoming bridge data
    • New panel interleave types (DoubleZ) and FBMatrix horizontal-flip support
    • Fan control: fan-on temperature, adjustable trip points, and fan-presence detection
    • GPIO overhaul for gpiod v2 / Trixie, including open-drain pin mode and support for GPIO expanders without an INT pin
    • EEPROM upgrade improvements with automatic hardware selection
    • uDMX enhancements and a new servo API command

  • WLED Compatibility

    • WLED-Native discovery API and a simple overlay UI that WLED-Native can drive
    • WLED audio-reactive networking and additional ported WLED FX effects
    • RGBW support in Pixel Overlay Model systems

  • Backend Improvements

    • HTTP layer moved from libhttpserver to the drogon framework
    • Distributed compilation via distcc/nocc (offload builds from a slow BBB/Pi Zero to a fast Pi 5)
    • Playwright UI testing, a Dev Container, and Docker matrix (amd64/arm64) builds
    • asan/tsan build targets
    • Crash-reporting improvements (crash-handler watchdog, optional fpp_stats.json context)
    • Thread-safety cleanup: migration to std::thread/mutex and thread-safe APIs throughout

Major Changes/Incompatibilities

  • Due to the upgrade from Debian 12 to Debian 13, many libraries have been upgraded to new versions. Some incompatibilities are expected, primarily with plugins. Most plugins will need to be updated/reinstalled.

  • An "OS Level" upgrade is required — there is no in-place software-only update from FPP 9.x.

  • New 64-bit Raspberry Pi images. Switching between 32-bit and 64-bit is not supported by an in-place OS upgrade — moving a 64-bit capable Pi to the 64-bit image requires flashing a fresh image (back up your config first).

  • The VLC and SDL media backends have been removed and replaced by GStreamer/PipeWire.

  • The rpi_ws281x driver has been dropped; Raspberry Pi string outputs now use DPIPixels.

  • The "FPD" dongle / PixelNet output has been removed (it was deprecated in 9.0).

  • The "Remote XXXX" FPP commands (e.g. "Remote Playlist Start") have been removed (deprecated in 9.0). Use the normal FPP command with the MultiSync checkbox and target set.

  • Time sync now uses chrony instead of ntpsec.

  • Only in-kernel WiFi drivers are included; some older USB WiFi adapters may no longer work.

    Upgrading to FPP10

    Important: FPP10 needs a OS level upgrade. If your Pi can run 64-bit (Pi 3/4/5, Zero 2W, CM4/CM5), we recommend changing to the 64-bit image.

    Option A — Fresh install (required if moving 32-bit → 64-bit)

    1. Back up your FPP config.
    2. Flash the new FPP10 image to your SD card/drive.
    3. Restore your config.

    Option B — In-place upgrade (only if staying on the same architecture)

    1. Make sure you're on the latest FPP 9.x (or fully updated 8.x) first.
    2. Go to About → Upgrade OS, pick the 10.0 image for your board.
    3. Let it download, install, and reboot.
    4. Delete the fppos file from File Manager → Uploads.
    5. If it fails to boot afterward, just power-cycle it — some devices need that due to library changes.

    Which image do I need?

    Board Image
    64-bit capable Pi (3/4/5, Zero 2W, CM4/CM5) FPP-v10.0-Pi64.img.zip
    Older/32-bit-only Pi FPP-v10.0-Pi.img.zip
    BeagleBone Black/Green/PocketBeagle/Green Gateway FPP-v10.0-BBB.img.zip
    PocketBeagle2 FPP-v10.0-BB64.img.zip

    Other Debian/Ubuntu or Armbian-based SBCs don't have a pre-built image — install from source instead.

Clone this wiki locally