5.3

Enhancements

• Updated to latest external Realtek WIFI drivers (requires OS update via re-image or fppos - optional)
• Speed up boot by autoloading discovered drivers/modules for WIFI and sound
• Sort list of scripts
• Virtual Matrix max size increased to allow 4 digit dimmensions
• Add Override Zero Output Processor (useful for moving heads)
• Display all sensors on wider browser windows
• Add setting to prioritize sequence data over bridge data
• Add support for newer Falcon smart receivers that can chain up to 6 receivers

Bug Fixes

• More updates to VLC to reduce VLC freezing issues
• Avoid NaN in calculated playlist length
• Fix some issues with special characters in media files and sequences
• Don't suggest BBB fppos files on Debian/Docker/unknown systems
• If an output configuration json file is corrupt, add a warning about that file, but continue to process other output configurations
• Fix "flash" on boot on BBB pixel capes
• Fix FPP Backups not backing up all json config files and network interface files
• Fix crashes using "Start Playlist" FPP Command without proper number of arguments
• Fix BBBSerial not recording the proper first channel it needs
• Fix merging/sorting of required ranges so FPP connect can produce a better fseq file

Installation Instructions

If you have a system running 5.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear on the main status page. Click on that to start the update process. It may take a long time to upgrade. Likely 5-10 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

NOTE: The updated WIFI drivers are an OS level update and will require using the "fppos" method to update to the 5.3 OS level.

For users of FPP 4.x or older, it is strongly recommended to do a full "OS Level" upgrade or re-image instead of attempting to upgrade directly from any older FPP version. There are several new features that will not work if an OS level upgrade is not done. There are two ways to do so:

• Re-image - you can backup your 4.x configuration, create a new image, and restore the configuration.
• In-place upgrade - this is new and requires you to have FPP 3.6.2 (or 4.0-alpha2) or newer already running on the device. Download the appropriate "fppos" file to your computer. Make sure the file extension is still fppos (some browsers will rename it). Upload it to the "File Manager" on the FPP instance. Then go to the about page. Under the normal "Manual Upgrade", a new Upgrade OS button should appear. Click it and wait a LONG time. When done, it should reboot into 5.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 Raspberry Pi series including Pi B, Pi B+, Pi 3, Pi 3+, Pi 4 and Pi Zero use this image

• FPP-v5.3-Pi.img.zip

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

• FPP-v5.3-BBB.img.zip

5.2

Enhancements

• Selecting hash in ChangeLog will now prompt to revert to that version or view the changes on GitHub
• About page can now download the fppos update files directly
• Support for new capes (new RTC clock chips, Panel/pixel combination capes, etc...)
• Add description fields to some of the outputs on the Other page
• Adds Sensor information to about page

Bug Fixes

• Fix "Command Failed" message on Reboot/Shutdown
• Fix UI password not working for various endpoints
• Fix bugs with string page allowing fractional channels
• Fix UDP de-duplication not working correctly when configuration pushed from xLights
• Fix "Force HDMI Display" not forcing the second port on a Pi4

Installation Instructions

If you have a system running 5.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear on the main status page. Click on that to start the update process. It may take a long time to upgrade. Likely 5-10 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

NOTE: there are no OS level updates in this release. The "FPP OS Build" will remain v5.0.

For users of FPP 4.x or older, it is strongly recommended to do a full "OS Level" upgrade or re-image instead of attempting to upgrade directly from any older FPP version. There are several new features that will not work if an OS level upgrade is not done. There are two ways to do so:

• Re-image - you can backup your 4.x configuration, create a new image, and restore the configuration.
• In-place upgrade - this is new and requires you to have FPP 3.6.2 (or 4.0-alpha2) or newer already running on the device. Download the appropriate "fppos" file to your computer. Make sure the file extension is still fppos (some browsers will rename it). Upload it to the "File Manager" on the FPP instance. Then go to the about page. Under the normal "Manual Upgrade", a new Upgrade OS button should appear. Click it and wait a LONG time. When done, it should reboot into 5.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 Raspberry Pi series including Pi B, Pi B+, Pi 3, Pi 3+, Pi 4 and Pi Zero use this image

• FPP-v5.2-Pi.img.zip

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

• FPP-v5.2-BBB.img.zip

5.1

Enhancements

• New MQTT channel output to publish channel values to an MQTT topic
• Allow turning off the IP announcement on non Pi platforms
• Better support for the rPi-MFC Hat to only present a single output string to configure
• Add a bunch of new API's to the playlist/player code to support new functionalities of the SMPTE and ArtNet Advanced plugins
• On "Wide" browsers, display the full IP address

Changes/Incompatibilities

• ArtNet timecode support was removed from FPP and moved into the FPP ArtNet Advanced plugin which provides additional ArtNet functionality

Bug Fixes

• Fix some usability issues with the "Tabs" on mobile browsers
• Fix several crashes that have been identitified
• Fix MQTT topic /set/playlist/PLAYLISTNAME/start not working correctly
• Fix some issues with the exim/email credentials not being usable
• Use Boot Delay setting to also wait for missing Wifi adapters. Some wifi adapters are taking a while for the Linux kernel to detect and initialize.
• Fix "Remote Trigger Preset Slot" FPP Command not working correctly
• Fix some schedule/timing issues with times between midnight-1am and noon-1pm.
• Fix offsets appearing with AM/PM time formats
• Fix "Flash to eMMC BTRFS" not working

Installation Instructions

If you have a system running 5.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear on the main status page. Click on that to start the update process. It may take a long time to upgrade. Likely 5-10 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

NOTE: there are no OS level updates in this release. The "FPP OS Build" will remain v5.0.

For users of FPP 3.x or older, it is strongly recommended to do a full "OS Level" upgrade or re-image instead of attempting to upgrade directly from any older FPP version. There are several new features that will not work if an OS level upgrade is not done. There are two ways to do so:

• Re-image - you can backup your 4.x configuration, create a new image, and restore the configuration.
• In-place upgrade - this is new and requires you to have FPP 3.6.2 (or 4.0-alpha2) or newer already running on the device. Download the appropriate "fppos" file to your computer. Make sure the file extension is still fppos (some browsers will rename it). Upload it to the "File Manager" on the FPP instance. Then go to the about page. Under the normal "Manual Upgrade", a new Upgrade OS button should appear. Click it and wait a LONG time. When done, it should reboot into 5.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 Raspberry Pi series including Pi B, Pi B+, Pi 3, Pi 3+, Pi 4 and Pi Zero use this image

• FPP-v5.1-Pi.img.zip

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

• FPP-v5.1-BBB.img.zip

5.0

FPP 5.0

• FPP 5.0
• Enhancements
• Major Changes/Incompatibilities
• Other updates/changes
• Upgrade Instructions
  • Selecting an image

Enhancements

• Interface/"Look and Feel" Updates
  • The entire FPP UI has been completely re-written to be more "modern" and mobile friendly. We tried to keep it familiar to FPP users, yet "new and fresh".
  • New "Wizard" on first startup to help configure FPP for the first time
  • Troubleshooting page updated to run commands asynchronously and provide direct links to needed results.
  • Display testing page updated to provide easier adjustments to channel ranges and test settings
  • MultiSync Page updates to provide faster updates and much more information
  • New Privacy settings to prevent callouts to 3rd party sites for vendor logos, statistics, etc...
• Audio configured to use "dmix" when possible to allow simultaneous audio streams (ex: "Play Media" FPP command can play sound effects from GPIO triggers while show is running)
• Scheduler Enhancements:
  • Global disable of scheduler to easily disable all scheduled events
  • Allow scheduling of FPP Commands that can execute independently of playlists
  • Allow scheduling of FSEQ files directly so playlists do not need to be created for single sequences
  • Added Preview button to main status page and Scheduler page to preview the upcoming scheduled items
  • Added Dusk/Dawn options to the Scheduler (in addition to SunSet/SunRise). Requires location (Latitude and Longitude) to be set.
• Pixel Overlay Model Enhancements:
  • Many built in effects for use on Pixel Overlay Models (from WLED project)
  • Automatically create Pixel Overlay Models from descriptions on Pixel Strings and Matrices
• New Phillips KiNet output support
• Popup "Run FPP Command" trigger button in footer allowing easy execution of commands from with UI
• Several enhancements for using FPP in Docker:
  • Auto-set the hostname FPP uses if specified in docker config
  • Auto-set the host description to include the container ID if the description has not been set by the user.
  • Expose the host description setting on the System settings tab when running in docker since the network settings page is not shown.
  • Allow FPP to advertise the external host IP docker is using by setting a FPP_DOCKER_IP environment variable when the container is spawned or by using a setting on the System page
  • Hook up reboot/shutdown actions to kill apache2 when running in docker to trigger the container to shutdown or restart (actual action depends on how the container is configured)
  • Added a sample docker-compose.yml config in docs/samples which uses the FPP image created by dockerBuild.sh or from the docker repo.
• Pixel String Outputs:
  • Unify the BBB Strings, Pi Pixel Strings, and X11 Pixel Strings pages into a single consistent page
  • Add "End Nulls" option for each virtual pixel string

Major Changes/Incompatibilities

• Legacy API has been removed. See the API conversion guide for more information
• "Bridge mode" has been removed. Instead, if e1.31/ArtNet/DDP channel inputs are enabled on the Channel Inputs page, they are always active in both Player and Remote modes. Any incoming channel data will override what is loaded from a sequence. This allows combining pre-rendered sequence data with live data.
• Retirement of Legacy APIs
• "Master mode" has been removed. internally, master mode has always been really just player mode with a setting to send out sync packets. This is now reflected in the UI. Thus, FPP now only has two modes: Player and Remote. Either can receive incoming e1.31/ArtNet/DDP data if the Inputs are enabled. A Player can be configured to send sync packets and/or E1.31/DDP/ArtNet data as needed. A Remote will work as before.
• FPP Events have been changed to "Command Presets". This allows more descriptive names/titles of the events which can make it easier to trigger. There is a now a single trigger channel so users using multiple command channels will need to adjust their configuration.
  • Several stock Command Preset names are called within FPP: FPPD_STARTED, FPPD_STOPPED, PLAYLIST_STARTED, PLAYLIST_STOPPED, PLAYLIST_STOPPING_NOW, PLAYLIST_STOPPING_AFTER_LOOP, PLAYLIST_STOPPING_GRACEFULLY, SEQUENCE_STARTED, SEQUENCE_STOPPED, MEDIA_STARTED, MEDIA_STOPPED

Other updates/changes

• MQTT - now publishes warnings

• Additional warnings for common issues like outputting sound to Dummy devices
• Tons of new REST API's added to support the new UI. Many of the older fppxml.php and fppjson.php calls have been removed. Users using those API's will need to move to the new REST API's. See the API conversion guide for more information
• Capes/Hats that provide string functionality can remove the "Generic" names in the UI and display the cape names

Upgrade Instructions

It is strongly recommended to do a full "OS Level" upgrade or re-image instead of attempting to upgrade directly from any older FPP version. There are several new features that will not work if an OS level upgrade is not done. There are two ways to do so:

• Re-image - you can backup your 4.x configuration, create a new image, and restore the configuration.
• In-place upgrade - this is new and requires you to have FPP 3.6.2 (or 4.0-alpha2) or newer already running on the device. Download the appropriate "fppos" file to your computer. Make sure the file extension is still fppos (some browsers will rename it). Upload it to the "File Manager" on the FPP instance. Then go to the about page. Under the normal "Manual Upgrade", a new Upgrade OS button should appear. Click it and wait a LONG time. When done, it should reboot into 5.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 Raspberry Pi series including Pi B, Pi B+, Pi 3, Pi 3+, Pi 4 and Pi Zero use this image

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

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

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

5.0-alpha1

This is an early "Alpha" level release of FPP 5.0 images. These are based on entirely new/updates OS images for both the Pi and BBB. The linux kernel has been updated on both platforms which may cause various issues. Much more testing is needed.

Known issues Common:

Known issues Raspberry Pi:

• Many of the external/USB Wifi adapters that worked with the 4.x images will not work on the Pi. (Beagles should be fine)
• SSH host keys may not be generated, logging in via ssh won't work. This can be "fixed" by using the SSH shell (which isn't really SSH) from the Help menu in FPP to login and then run "sudo /usr/bin/ssh-keygen -A" and then reboot
• Audio does not work using the Pi's built in headphone jack. This is fixed on the latest master. Do a manual update and then reboot to pick up the changes.

Known issues Beaglebones:

4.6.1

Enhancements

• Add wireless information to Troubleshooting page
• Add warning if universes active but main UDP channel output disabled
• Save sort order on Multisync page

Bug Fixes

• Don't publish MQTT idle events when exiting a child playlist
• Don't randomize playlist on load if starting position passed in
• Fix MAX_CHANNELS on Other tab preventing large virtual matrices
• Make sure dnsmasq doesn't wipe out the resolve.conf that connman creates
• Remove "Restart DNS" button as it doesn't actually do anything at all
• Make some tweaks to the video sync timing to help minimize the chances of video freeze-ups
• Fix changelog link not showing on about page

Installation Instructions

If you have a system running 4.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear on the main status page. Click on that to start the update process. It may take a long time to upgrade. Likely 5-10 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

For users of FPP 3.x or older, it is strongly recommended to do a full "OS Level" upgrade or re-image instead of attempting to upgrade directly from any FPP 2.x or 3.x version. There are several new features that will not work if an OS level upgrade is not done. There are two ways to do so:

• Re-image - you can backup your 3.x configuration, create a new image, and restore the configuration.
• In-place upgrade - this is new and requires you to have FPP 3.6.2 (or 4.0-alpha2) or newer already running on the device. Download the appropriate "fppos" file from the FPP 4.6 release to your computer. Make sure the file extension is still fppos (some browsers will rename it). Upload it to the "File Manager" on the FPP instance. Then go to the about page. Under the normal "Manual Upgrade", a new Upgrade OS button should appear. Click it and wait a LONG time. When done, it should reboot into 4.6. 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. After it's running, go to the about page and hit the "Manual Update" button to update from 4.6 to 4.6.1.

Selecting an image

For Raspberry Pi series including Pi B, Pi B+, Pi 3, Pi 3+, Pi 4 and Pi Zero use this image

• FPP-v4.6.1-Pi.img.zip

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

• FPP-v4.6.1-BBB.img.zip

4.6

Note: There are NO OS level updates in this release. OS level will still report as 4.4.

Enhancements

• New X11PanelMatrix output for testing panel matrix code
• New Wifi Strength indicator to title bar and Multisync page
• Move unicast sync checkbox to beside the IP address to allow specific IP to be chosen
• New warning if Debug/Excessive logging is enabled
• New "Loop" test for Branch playlist item to execute every Xth iteration
• New "Playlist" destination for Branching to invoke a new playlist then return to original when done
• New Multisync packet stats on Remotes
• New ability to randomize a playlist on load or per iteration
• Optimize HTTP discovery to be faster/parallel
• HTTP Discovery allows ranges to be specified ("192.168.2[100-150]")
• Discover DIYLEDExpress E1.31 Bridge via HTTP discovery
• Add some extra information into MQTT status messages
• New "Enhanced LOR Protocol" support to send channel data to Pixie controllers
• New Advanced UI setting to disable the fake e1.31/DDP listeners.
• New "Effects Stop" FPP Command to stop all running effects
• New API for retrieving Overlay model data in a simple RLE format to reduce bandwidth/cpu usage
• New Advanced UI button to install/enable Kiosk mode instead of having a separate Kiosk image
• Developer Mode: add ability to jump to specific git hash

Bug Fixes

• Fix problems with playlist editor if filenames/playlist names have various special HTML characters (like amp)
• Fix "help" text for -t argument to fpp command line
• Fix problems with date picker in scheduler UI
• Fix some problems with plugins and other settings that may have HTML special characters
• Fix Multisync controller detection of F16v2R and F4v2
• Fix excess logs relating to variable header length check
• Fix "dedup" of UDP packets using wrong channel offsets
• Fix some problems with Priority based scheduling not taking end time into consideration properly
• Fix password character length to allow longer passwords
• Fix BBB String page not allowing ports 1-16 to be an "Expansion" type
• Fix some issues of blanking between sequences if certain plugins (like brightness) are installed
• Fix bugs with "Stop after loop" not working properly
• Fix some issues with subcommands not refreshing properly in various FPP Command editors
• Fix some crashes if HTTP discovers controllers via hostname instead of IP address
• Fix missing "git version" on Multisync page
• Fix some scheduler issues with playlists stopping prematurely
• Fix some scheduler issues with repeats that cross the weekend boundary
• Fix Image playlist entry type trying to find images if path not specified
• Fix Image playlist entry not displaying correctly on 1366x768 monitor
• Fix "/stop/afterloop" MQTT Topic
• Fix call to VLC to adjust rate less often to reduce problems with video stopping
• Fix problems with start/stop playlist from OLED if UI password is set
• Fix some routing/dns issues if a gateway is not set on an interface
• Reduce the frequency and intensity of the ping/monitor process to reduce impact on already overloaded controllers/networks
• Fix crashes if logging channel data

Installation Instructions

If you have a system running 4.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear on the main status page. Click on that to start the update process. It may take a long time to upgrade. Likely 5-10 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

For users of FPP 3.x or older, it is strongly recommended to do a full "OS Level" upgrade or re-image instead of attempting to upgrade directly from any FPP 2.x or 3.x version. There are several new features that will not work if an OS level upgrade is not done. There are two ways to do so:

• Re-image - you can backup your 3.x configuration, create a new image, and restore the configuration.
• In-place upgrade - this is new and requires you to have FPP 3.6.2 (or 4.0-alpha2) or newer already running on the device. Download the appropriate "fppos" file to your computer. Make sure the file extension is still fppos (some browsers will rename it). Upload it to the "File Manager" on the FPP instance. Then go to the about page. Under the normal "Manual Upgrade", a new Upgrade OS button should appear. Click it and wait a LONG time. When done, it should reboot into 4.6. 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 Raspberry Pi series including Pi B, Pi B+, Pi 3, Pi 3+, Pi 4 and Pi Zero use this image

• FPP-v4.6-Pi.img.zip

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

• FPP-v4.6-BBB.img.zip

4.5

Note: There are NO OS level updates in this release. OS level will still report as 4.4.

Enhancements

• Update Raspberry Pi ws281x and spixel libraries to support latest Raspberry Pi 4 hardware
• Update FSEQ files to support additional compression blocks for very large sequences
• Update BBB pcm5102a audio overlay to use a more accurate clock
• Update multisync.php page to gather all the FPP remote information in one call, big performance boost
• Playlist selection box is now resizable
• Change wording on Multisync page to "Unicast Sync" instead of "Enable Sync"
• Display errors in playlist UI if sequence or media cannot be found

Bug Fixes

• Fix some flashing on various BBB pixel ports if serial output is also enabled
• Fix some flashing on various BBB pixel ports, particularly with smart receivers
• Fix updating FPP from another FPP instance not updating submodules
• Remove extra line printed from /opt/fpp/src/fpp that was causing issues with some scripts
• Fix problems if a network interface ends up with multiple ip addresses
• Fix problems with "fpp -v" volume control with some USB sound devices
• Fix several bugs with sub playlists in the UI code
• Fix several bugs with dynamic playlists
• Fix crashing if UDP output is targeting another FPP instance
• Fix bugs with calendar widget on schedule page if loading an old schedule from last year
• Fix problems of calendar not appearing for newly added schedule rows
• Fix FPP commands not appearing for api/help.php

Installation Instructions

If you have a system running 4.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear on the main status page. Click on that to start the update process. It may take a long time to upgrade. Likely 5-10 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

For users of FPP 3.x or older, it is strongly recommended to do a full "OS Level" upgrade or re-image instead of attempting to upgrade directly from any FPP 2.x or 3.x version. There are several new features that will not work if an OS level upgrade is not done. There are two ways to do so:

• Re-image - you can backup your 3.x configuration, create a new image, and restore the configuration.
• In-place upgrade - this is new and requires you to have FPP 3.6.2 (or 4.0-alpha2) or newer already running on the device. Download the appropriate "fppos" file to your computer. Make sure the file extension is still fppos (some browsers will rename it). Upload it to the "File Manager" on the FPP instance. Then go to the about page. Under the normal "Manual Upgrade", a new Upgrade OS button should appear. Click it and wait a LONG time. When done, it should reboot into 4.5. 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 Raspberry Pi series including Pi B, Pi B+, Pi 3, Pi 3+, Pi 4 and Pi Zero use one of these images

• FPP-v4.5-Pi.img.zip
• FPP-v4.5-Pi-Kiosk.img.zip

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

• FPP-v4.5-BBB.img.zip

4.4

Enhancements

• Priority based scheduling - playlists higher in the schedule will interrupt lower playlists
• Add shutdown/reboot options to MultiSync actions
• Add bridge/master/remote/standalone mode options to MultiSync actions
• Ability to specify the HDMI resolution for the HDMI ports on the Pi
• Hide the WIFI password and tether passwords
• Increase panel width limit to 24
• Add a tail to the File Manager log viewer

Bug Fixes

• Fix problems with ampersands in string descriptions for BBB Strings and Pi Pixel Strings
• Fix problems with model wish slashes in the name cause fppd to crash
• Fix force_hdmi setting on Pi, also sets force_hdmi for second hdmi port on Pi4
• Reduce log levels in some cases to avoid logs growing unnecessarily
• Fix problems with SSID names that are too long and/or contain spaces
• Fix problems trying to stop scheduled playlists
• Fix high CPU usage with BBB Panels and Pixels with large channel counts
• Fix one based DDP output not outputting correct channels

Installation Instructions

If you have a system running 4.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear on the main status page. Click on that to start the update process. It may take a long time to upgrade. Likely 5-10 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process. This method will get all the updates above except those marked with *. Those changes will require a re-image or use of the "fppos" update method described below.

For users of FPP 3.x or older, it is strongly recommended to do a full "OS Level" upgrade or re-image instead of attempting to upgrade directly from any FPP 2.x or 3.x version. There are several new features that will not work if an OS level upgrade is not done. There are two ways to do so:

• Re-image - you can backup your 3.x configuration, create a new image, and restore the configuration.
• In-place upgrade - this is new and requires you to have FPP 3.6.2 (or 4.0-alpha2) or newer already running on the device. Download the appropriate "fppos" file to your computer. Make sure the file extension is still fppos (some browsers will rename it). Upload it to the "File Manager" on the FPP instance. Then go to the about page. Under the normal "Manual Upgrade", a new Upgrade OS button should appear. Click it and wait a LONG time. When done, it should reboot into 4.4. 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 Raspberry Pi series including Pi B, Pi B+, Pi 3, Pi 3+, Pi 4 and Pi Zero use one of these images

• FPP-v4.4-Pi.img.zip
• FPP-v4.4-Pi-Kiosk.img.zip

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

• FPP-v4.4-BBB.img.zip

4.3.1

Enhancements

• Add midi devices and video debug information to troubleshooting page
• Add optional "If not running" flag to all the Start/Insert playlist commands

Bug Fixes

• Fix 1 based DDP output sending wrong channels
• Fix "ForceHDMI" setting not working, persist across fppos upgrade
• Reduce black blanking between sequences on VirtualMatrix

Installation Instructions

If you have a system running 4.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear on the main status page. Click on that to start the update process. It may take a long time to upgrade. Likely 5-10 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process. This method will get all the updates above except those marked with *. Those changes will require a re-image or use of the "fppos" update method described below.

For users of FPP 3.x or older, it is strongly recommended to do a full "OS Level" upgrade or re-image instead of attempting to upgrade directly from any FPP 2.x or 3.x version. There are several new features that will not work if an OS level upgrade is not done. There are two ways to do so:

• Re-image - you can backup your 3.x configuration, create a new image, and restore the configuration.
• In-place upgrade - this is new and requires you to have FPP 3.6.2 (or 4.0-alpha2) or newer already running on the device. Download the appropriate "fppos" file to your computer. Make sure the file extension is still fppos (some browsers will rename it). Upload it to the "File Manager" on the FPP instance. Then go to the about page. Under the normal "Manual Upgrade", a new Upgrade OS button should appear. Click it and wait a LONG time. When done, it should reboot into 4.3.1. 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 Raspberry Pi series including Pi B, Pi B+, Pi 3, Pi 3+, Pi 4 and Pi Zero use one of these images

• FPP-v4.3.1-Pi.img.zip
• FPP-v4.3.1-Pi-Kiosk.img.zip

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

• FPP-v4.3.1-BBB.img.zip