Skip to content

Releases: betaflight/blackbox-log-viewer

2025.12.1

14 Feb 08:45

Choose a tag to compare

Important

2025.12.1 is online only:
Blackbox Explorer is now available as a web app, no need to install a file locally, just head to: https://blackbox.betaflight.com

If you want to still wish to install the app for offline usage, then head to https://blackbox.betaflight.com and then please follow the instructions below:

Release Notes

What's Changed

Improvements

  • Added setting of minimum and maximum curves values on the graphs. VITE Web version. by @demvlad in #726
  • Associate .bbl and .bfl files with PWA by @McGiverGim in #749
  • Auto fill of curves table by selecting group curves names on Chart setup dialog box by @demvlad in #747
  • Restore various default workspaces by using menu by @demvlad in #745
  • add dyn_idle_start_increase parameter to header view by @nerdCopter in #750
  • Update FFT_FREQ debug fields by @haslinghuis in #759
  • Add mcu_id to statusbar by @haslinghuis in #763
  • Added ALTHOLD flight mode marker at the chart for 4.6 BF firmware by @demvlad in #767
  • Added cartesian gps coords relative home point as additional computed fields by @demvlad in #773
  • The azimuth of Home point added as computed field by @demvlad in #774
  • Add browser check by @haslinghuis in #778
  • Export of spectrum analyzer data to Csv file by @demvlad in #779
  • Added spectrum comparison by using import spectrum data from CSV file by @demvlad in #780
  • Deprecate gps-rescue-throttle-pid and replace with autopilot-altitude by @haslinghuis in #784
  • Remove gyro_scaled by @haslinghuis in #781
  • Added curves legend at multi-curves spectrum by @demvlad in #786
  • Update ATTITUDE debug by @haslinghuis in #791
  • Added curves settings for axis_s log fields (for airplanes) by @demvlad in #789
  • Added computing of heading[] fields from new flight attitude quatrernion log data by @demvlad in #790
  • Add missing debug modes by @haslinghuis in #796
  • Resolved issues of show motor_idle and motors Start inc header fields for BF 4.6 log files by @demvlad in #797
  • Added POSITION HOLD flight mode show by @demvlad in #788
  • Add SERVO disable field by @haslinghuis in #800
  • Add AUTOPILOT_POSITION and OPTICALFLOW debug modes by @demvlad in #803
  • Update IMU (remove legacy) by @haslinghuis in #802
  • Add IMM42653 by @haslinghuis in #807
  • The units converters are added for TPA (WING) debug fields by @demvlad in #808
  • Added chirp parameters to header by @pichim in #658
  • The S component is added into PID sum curves data for wings by @demvlad in #817
  • Added power spectral density curves at the spectrum chart by @demvlad in #820
  • Added Power Spectral Density curves at the spectrum chart (Completion of #820 PR) by @demvlad in #826
  • The spectrum charts improvements. by @demvlad in #833
  • The min and max heatmap PSD values settings are stored for continous using by @demvlad in #843
  • Added PSD curves export and import to compare several spectrums at the chart by @demvlad in #845
  • The simple PSD spectrum comparison of one log file data by @demvlad in #847
  • RC filter update by @haslinghuis in #852
  • Replace gyro_to_use with gyro_enabled_bitmask in header dialog by @haslinghuis in #862
  • Update MAG_HARDWARE by @haslinghuis in #861
  • Added TELEMETRY_MAVLINK debug fields settings by @demvlad in #864
  • Using of number input field for PSD segments length by @demvlad in #867
  • Added settings for GPS NED velocities fields by @demvlad in #872
  • Improved settings for DEBUG_MAVLINK_TELEMETRY fields. by @demvlad in #873
  • Added trajectory tilt angle computed field by @demvlad in #875
  • Show Thrust Linear in header TPA section by @SupaflyFPV in #877
  • The Lowpass dyn filter curves are drawn by using true throttle and expo values at the spectrum charts by @demvlad in #878
  • UI: Enabling Dark Mode by @blckmn in #884

Fixes

  • Fix error by loading default workspace, addition to #751 by @demvlad in #752
  • Fixed issues of first applications run by @demvlad in #753
  • Resolved issue of log records count and actual log rate computing by @demvlad in #755
  • Filtering out bad RPM values for spectrum chart by @demvlad in #757
  • Resolve issue of computing actual log rate for spectrum chart in case of data gaps in log file by @demvlad in #762
  • Bug fix for flight modes names at the chart by @demvlad in #764
  • Resolved issue of wrong log time computing by @demvlad in #765
  • Fix export video by @haslinghuis in #777
  • Resolved issue of compas (mag_adc[]) curves by @demvlad in #787
  • Fix panning by @haslinghuis in #793
  • Fix panning (2nd issue) by @haslinghuis in #794
  • Added ATTITUDE log disabled flag for BF gte 4.6 by @demvlad in #799
  • Fix type error by @haslinghuis in #806
  • Fix undefined video export dialog by @haslinghuis in #810
  • Added missing slices of data samples arrays in spectrum calc by @demvlad in #819
  • Revert "Added missing slices of data samples arrays in spectrum calc" by @demvlad in #831
  • Revert "Added Power Spectral Density curves at the spectrum chart (Completion of #820 PR)" by @demvlad in #830
  • Bug fix: The spectrum graph is sometimes not displayed after change spectrums type by @demvlad in #837
  • Revert "Bug fix: The spectrum graph is sometimes not displayed after change spectrums type" by @demvlad in #838
  • Bug fix: The spectrum graph is sometimes not displayed after change s… by @demvlad in #839
  • Removed superfluous dataBuffer in graph_spectrum to prevent the random spectrum type change bug by @demvlad in #841
  • Added CHIRP flight mode title by @demvlad in https://github.com/bet...
Read more

Blackbox Log Viewer 3.7.0

03 May 22:18
1374564

Choose a tag to compare

Important

4.0.0 and later is online only:
Blackbox Explorer is now available as a web app, no need to install a file locally, just head to: https://blackbox.betaflight.com

If you want to still wish to install the app for offline usage, then head to https://blackbox.betaflight.com and then please follow the instructions below:

Release Notes

This update of Blackbox Log Viewer adds support for logs written by the latest version of the Betaflight firmware (4.5).

We have tried to make this release as bug free as possible. If you still find a bug, please report it back to us by opening an issue here.

If you want to talk about Betaflight, ask configuration questions, or just hang out with fellow pilots, you can do this in our Facebook group.

Betaflight also has a presence with Discord. Register here. Most developers hang out there, so this is a great place to talk about the things you are tinkering with in Betaflight, or get help.

What's Changed

Improvements

Fixes

New Contributors

Full Changelog: 3.6.0...3.7.0

Blackbox Log Viewer 3.6.0

14 Jun 03:33
15f9a97

Choose a tag to compare

Which file do I need?

  • Windows (7, 8, 10): betaflight-blackbox-explorer-installer_<version>_win32.exe;
  • Mac OS X: betaflight-blackbox-explorer_<version>_macOS.dmg (please read 'Important information when upgrading' below);
  • Linux: betaflight-blackbox-explorer_<version>_amd64.deb (Ubuntu, debian), betaflight-blackbox-explorer-<version>.x86_64.rpm (Red Hat, Fedora, CentOS), betaflight-blackbox-explorer_<version>_linux64.zip (others).

Release Notes

This update of Blackbox Log Viewer adds support for logs written by the latest version of the Betaflight firmware (4.3).

We have tried to make this release as bug free as possible. If you still find a bug, please report it back to us by opening an issue here.

If you want to talk about Betaflight, ask configuration questions, or just hang out with fellow pilots, you can do this in our Facebook group.

Betaflight also has a presence in the Slack messaging platform. Register here, and then come join us in Slack. Most developers hang out there, so this is a great place to talk about the things you are tinkering with in Betaflight, or get help with really complicated configuration problems.

Important information when upgrading

  • Changes to the security model used in the latest versions of MacOS X 10.14 (Mojave) and 10.15 (Catalina) mean that the operating system will show an error message ('"Betaflight Blackbox Explorer.app" is damaged and can’t be opened. You should move it to the Trash.') when trying to install the application. To work around this, run the following command in a terminal before installing: sudo xattr -rd com.apple.quarantine /Applications/Betaflight\ Blackbox\ Explorer.app.

What's Changed

Improvements

Fixes

New Contributors

Full Changelog: 3.5.0...3.6.0

Blackbox Log Viewer 3.5.0

28 Apr 12:49
f9ea2b7

Choose a tag to compare

Which file do I need?

  • Windows (7, 8, 10): betaflight-blackbox-explorer-installer_<version>_win32.exe;
  • Mac OS X: betaflight-blackbox-explorer_<version>_macOS.dmg (please read 'Important information when upgrading' below);
  • Linux: betaflight-blackbox-explorer_<version>_amd64.deb (Ubuntu, debian), betaflight-blackbox-explorer-<version>.x86_64.rpm (Red Hat, Fedora, CentOS), betaflight-blackbox-explorer_<version>_linux64.zip (others).

Release Notes

This update of Blackbox Log Viewer adds support for logs written by the latest version of the Betaflight firmware (4.2).

We have tried to make this release as bug free as possible. If you still find a bug, please report it back to us by opening an issue here.

If you want to talk about Betaflight, ask configuration questions, or just hang out with fellow pilots, you can do this in our Facebook group.

Betaflight also has a presence in the Slack messaging platform. Register here, and then come join us in Slack. Most developers hang out there, so this is a great place to talk about the things you are tinkering with in Betaflight, or get help with really complicated configuration problems.

Important information when upgrading

  • Changes to the security model used in the latest versions of MacOS X 10.14 (Mojave) and 10.15 (Catalina) mean that the operating system will show an error message ('"Betaflight Blackbox Explorer.app" is damaged and can’t be opened. You should move it to the Trash.') when trying to install the application. To work around this, run the following command in a terminal before installing: sudo xattr -rd com.apple.quarantine /Applications/Betaflight\ Blackbox\ Explorer.app.

Improvements:

  • added the ability to take 'screenshots' of the graph (#392, #393);
  • added options to hide graph background and time bar (#408, #420);
  • added new PID error vs. setpoint graph (#416);
  • various UI improvements.

Fixes:

  • fixed a bug in the header display (#427);
  • fixed a number of incompatibilities with the firmware.

Blackbox Log Viewer 3.4.0

09 Oct 07:47
a954185

Choose a tag to compare

Which file do I need?

  • Windows (7, 8, 10): betaflight-blackbox-explorer-installer_<version>_win32.exe;
  • Mac OS X: betaflight-blackbox-explorer_<version>_macOS.dmg (please read 'Important information when upgrading' below);
  • Linux: betaflight-blackbox-explorer_<version>_amd64.deb (Ubuntu, debian), betaflight-blackbox-explorer-<version>.x86_64.rpm (Red Hat, Fedora, CentOS), betaflight-blackbox-explorer_<version>_linux64.zip (others).

Release Notes

This update of Blackbox Log Viewer adds support for logs written by the latest version of the Betaflight firmware (4.1).

We have tried to make this release as bug free as possible. If you still find a bug, please report it back to us by opening an issue here.

If you want to talk about Betaflight, ask configuration questions, or just hang out with fellow pilots, you can do this in our Facebook group.

Betaflight also has a presence in the Slack messaging platform. Register here, and then come join us in Slack. Most developers hang out there, so this is a great place to talk about the things you are tinkering with in Betaflight, or get help with really complicated configuration problems.

Important information when upgrading

  • Changes to the security model used in the latest versions of MacOS X 10.14 (Mojave) and 10.15 (Catalina) mean that the operating system will show an error message ('"Betaflight Blackbox Explorer.app" is damaged and can’t be opened. You should move it to the Trash.') when trying to install the application. To work around this, run the following command in a terminal before installing: sudo xattr -rd com.apple.quarantine /Applications/Betaflight\ Blackbox\ Explorer.app.

Fixes:

  • fixed a number of incompatibilities with the firmware.

Improvements:

  • improved spectrum graph (#290, #313);
  • added frequency vs. throttle graph (#322);
  • various UI improvements.

Blackbox Log Viewer 3.3.1

29 Apr 08:52

Choose a tag to compare

Important

Blackbox Log Viewer 3.3.1 was released to fix a bug in 3.3.0 that makes it impossible to open log files that were created with firmware older than Betaflight 4.0.0.

Which file do I need?

  • Windows (7, 8, 10): betaflight-blackbox-explorer-installer_<version>_win32.exe;
  • Mac OS X: betaflight-blackbox-explorer_<version>_macOS.dmg;
  • Linux: betaflight-blackbox-explorer_<version>_amd64.deb (Ubuntu, debian), betaflight-blackbox-explorer-<version>.x86_64.rpm (Red Hat, Fedora, CentOS), betaflight-blackbox-explorer_<version>_linux64.zip (others).

Release Notes

This update of Blackbox Log Viewer adds support for logs written by the latest version of the Betaflight firmware (4.0.0).

We have tried to make this release as bug free as possible. If you still find a bug, please report it back to us by opening an issue here.

If you want to talk about Betaflight, ask configuration questions, or just hang out with fellow pilots, you can do this in our Facebook group.

Betaflight also has a presence in the Slack messaging platform. Register here, and then come join us in Slack. Most developers hang out there, so this is a great place to talk about the things you are tinkering with in Betaflight, or get help with really complicated configuration problems.

Fixes:

  • Fixed a number of incompatibilities with the firmware;
  • Fixed bug making it impossible to open log files created with Betaflight < 4.0.0 (#308).

Improvements:

  • Added support for logs written by the latest firmware (4.0.0);
  • Added support for touch screen input;
  • Various UI improvements.

Blackbox Log Viewer 3.3.0

15 Apr 09:03
29aa523

Choose a tag to compare

Important

There is a bug in this version that makes it impossible to open log files that were created with firmware older than Betaflight 4.0.0. Blackbox Log Viewer 3.3.1 was released with a fix for this. Please update to Blackbox Log Viewer directly if you need to open log files that were created with older firmware versions.

Which file do I need?

  • Windows (7, 8, 10): betaflight-blackbox-explorer-installer_<version>_win32.exe;
  • Mac OS X: betaflight-blackbox-explorer_<version>_macOS.dmg;
  • Linux: betaflight-blackbox-explorer_<version>_amd64.deb (Ubuntu, debian), betaflight-blackbox-explorer-<version>.x86_64.rpm (Red Hat, Fedora, CentOS), betaflight-blackbox-explorer_<version>_linux64.zip (others).

Release Notes

This update of Blackbox Log Viewer adds support for logs written by the latest version of the Betaflight firmware (4.0.0).

We have tried to make this release as bug free as possible. If you still find a bug, please report it back to us by opening an issue here.

If you want to talk about Betaflight, ask configuration questions, or just hang out with fellow pilots, you can do this in our Facebook group.

Betaflight also has a presence in the Slack messaging platform. Register here, and then come join us in Slack. Most developers hang out there, so this is a great place to talk about the things you are tinkering with in Betaflight, or get help with really complicated configuration problems.

Fixes:

  • Fixed a number of incompatibilities with the firmware.

Improvements:

  • Added support for logs written by the latest firmware (4.0.0);
  • Added support for touch screen input;
  • Various UI improvements.

Blackbox Log Viewer 3.2.0

11 Aug 00:21
8143530

Choose a tag to compare

Which file do I need?

  • Windows (7, 8, 10): betaflight-blackbox-explorer-installer_<version>_win32.exe;
  • Mac OS X: betaflight-blackbox-explorer_<version>_macOS.dmg;
  • Linux: betaflight-blackbox-explorer_<version>_amd64.deb (Ubuntu, debian), betaflight-blackbox-explorer-<version>.x86_64.rpm (Red Hat, Fedora, CentOS), betaflight-blackbox-explorer_<version>_linux64.zip (others).

Release Notes

This update of Blackbox Log Viewer adds support for logs written by the latest version of the Betaflight firmware (3.5.0).

As usual, please report any bugs you find back to us by opening an issue here.

We also have a Facebook Group: If you want to talk about Betaflight, ask configuration questions, or just hang out with fellow pilots, you can do this here.

Fixes:

  • Fixed a number of incompatibilities with the firmware.

Improvements:

  • Added support for logs written by the latest firmware (3.5.0);
  • Various UI improvements.

Blackbox Log Viewer 3.1.0

08 Jul 03:28
85cd0f3

Choose a tag to compare

Which file do I need?

  • Windows (7, 8, 10): betaflight-blackbox-explorer-installer_<version>_win32.exe;
  • Mac OS X: betaflight-blackbox-explorer_<version>_macOS.dmg;
  • Linux: betaflight-blackbox-explorer_<version>_amd64.deb (Ubuntu, debian), betaflight-blackbox-explorer-<version>.x86_64.rpm (Red Hat, Fedora, CentOS), betaflight-blackbox-explorer_<version>_linux64.zip (others).

Release Notes

In addition to updating the Blackbox Log Viewer to support the latest version of the Betaflight firmware (3.4.0), we have added some nice new features: You can now double click on log files to open them, and you can export logs as CSV, in order to open them in third party tools like Plasmatree's PID-Analyzer.

We have also improved and polished up the user interface, and made it easier to take screenshots of logs that contain all of the information required for others to help you with tuning. Thanks to @McGiverGim, @wolkesson, and @ctzsnooze for their efforts on this!

As usual, please report any bugs you find back to us by opening an issue here.

We now also have a Facebook Group. If you want to talk about Betaflight, ask configuration questions, or just hang out with fellow pilots, you can do this here.

Important information when upgrading

  • The names of some graphs have been updated to make them more accurate and aligned with the firmware (#144, #164).

Fixes:

  • Fixed a number of incompatibilities with the firmware.

Improvements:

  • Added support for logs written by the latest firmware (3.4.0);
  • Various UI improvements;
  • Added support for opening log files by double-clicking them or dragging / dropping them onto the Blackbox Log Viewer app;
  • Added support for exporting log data as CSV.

Blackbox Log Viewer 3.0.0

12 Apr 17:28
b3ab5a3

Choose a tag to compare

The main change in this release is that the Blackbox Log Viewer is now available as a stand alone application. Thanks a lot for the hard work of the developers who made this possible!

In addition to this, this version contains fixes and updates to make it work with the log format generated with the latest release of Betaflight (3.3.1).