Skip to content

Preliminary FPP10 release notes

Jump to bottom
Daniel Kulp edited this page Jul 20, 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)
    • Automatic installation of plugin dependencies with hardened apt handling and package-owner tracking
    • Python dependency support via pipx/uv
    • Support for installing private plugins using GitHub credentials
    • 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
  • 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: 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
  • New features for Developers
    • 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.

Upgrade Instructions

Due to incompatibilities with the libraries and versions in Debian 12, an "OS Level" upgrade is required. There is no in-place software-only update from FPP 9.x.

If you have a 64-bit capable Pi (Pi 3, 4, 5, Zero 2W, CM4/CM5), we strongly recommend re-imaging with the new 64-bit Pi64 image rather than staying on a 32-bit system. Switching architectures cannot be done as an in-place upgrade.

  • Re-image (recommended) — Back up your configuration, flash a fresh FPP 10 image, then restore the configuration. This is the only way to move a 32-bit system to the new 64-bit image.
  • In-place upgrade (same architecture only) — This requires you to have the latest FPP 9.x (or the latest 8.x with all updates) already running on the device. On the "About" page in FPP, there is an "Upgrade OS" choice selection where the appropriate 10.0 image can be selected. FPP will automatically download the fppos file and install the upgrade. It will take a LONG time. When done, it should reboot into 10.0. At that point, go to the Uploads tab of the FPP File Manager and delete the fppos file. Note: In SOME cases, the reboot will fail due to library replacement. In that case, a power cycle may be required to get it back up and running.

Selecting an image

For 64-bit capable Raspberry Pi's (Pi 3, Pi 4, Pi 5, Pi Zero 2W, Compute Module 4/5) — recommended

  • FPP-v10.0-Pi64.img.zip

For older / 32-bit-only Raspberry Pi's (Pi B, Pi B+, Pi Zero, Pi Zero W)

  • FPP-v10.0-Pi.img.zip

For Beaglebone Black, Beaglebone Green, PocketBeagle, and Beaglebone Green Gateway use this image

  • FPP-v10.0-BBB.img.zip

For PocketBeagle2 use this image

  • FPP-v10.0-BB64.img.zip

Additional features not part of the Pi/BBB Images

Clone this wiki locally