Skip to main content

indiflight_log_tools

Decode Indiflight blackbox logs (.BFL) quickly into pandas dataframes, in raw or SI units. Includes the bfl2csv and bfl2rerun command line tools.

A C decoder (based on Betaflight's blackbox_decode) does the parsing, and Python then applies the unit conversions for Indiflight.

Installation

Supported: Linux (x86_64, aarch64) and macOS (Intel, Apple Silicon) with Python 3.10 or newer. PyPI has prebuilt wheels for these, so you don't need a compiler.

Windows: use WSL. The decoder doesn't build natively on Windows yet. Install WSL with Ubuntu (wsl --install in PowerShell, see the Microsoft guide), then follow the Linux instructions inside the Ubuntu terminal. Plot windows open on the Windows desktop (WSLg, Windows 10 21H2+ or Windows 11).

A virtual environment is recommended, so the package doesn't conflict with your system Python:

python3 -m venv ~/indiflight-venv
source ~/indiflight-venv/bin/activate     # run this again in every new terminal

On Ubuntu/Debian/WSL you may first need sudo apt install python3-venv python3-tk (python3-tk provides the matplotlib plot window backend).

From PyPI:

pip install indiflight_log_tools
pip install "indiflight_log_tools[rerun]"   # optional, needed for bfl2rerun / addToRerun()

From the git repo (compiles the C decoder, so needs gcc or clang):

pip install "git+https://github.com/tudelft/indiflight#subdirectory=support/LogAnalysis/indiflight_log_tools"

From a local checkout of the indiflight repo (-e for development):

pip install -e support/LogAnalysis/indiflight_log_tools

Upgrading from a version installed before 0.3.0? Run pip uninstall indiflight_log_tools first, so that the old bfl2csv and bfl2rerun scripts are removed.

Check the installation:

cd ~/    # or anywhere else, but not the source folder
python -c "from indiflight_log_tools import IndiflightLog; print(IndiflightLog.LIBRARY_SO)"

Usage

from indiflight_log_tools import IndiflightLog

log = IndiflightLog("/path/to/log.bfl", logId=3)                                  # if multiple logs in the same logfile, use this to select the one you want. default 1
log = IndiflightLog("/path/to/log.bfl", resetTime=False)                          # resetTime maintains the flight controller time as the time basis in the dataframe (default True)
log = IndiflightLog("/path/to/log.bfl", resetTime=False, timeRange=(1000, 3000))  # crop the data to timeRange (given in ms)

log.raw                                                                           # pandas dataframe in raw units
log.data                                                                          # pandas dataframe in SI units
log.parameters                                                                    # dict of the settings in the log header
log.events                                                                        # list of logged events
log.modeToText(log.data["flightModeFlags"])                                       # convert flight mode flag(s) into human-readable format
log.flags                                                                         # flight mode changes with timestamp
[(t, log.modeToText(x), log.modeToText(y)) for t, x, y in zip(log.flags["timeUs"], log.flags["enable"], log.flags["disable"])] # flight mode changes in human readable format

log.outputCsv("raw")                                                              # output raw data as csv, comparable to outputting from BB log explorer
log.outputCsv("si")                                                               # output SI data as csv
log.outputCsv("si", path="my/path/for/logOutput/")                                # output SI data into a specific path

log.addToRerun(name="BFL", clockOffsetSeconds=0.)                                 # send data to Rerun (does not do init, connect, etc. just adding data)

Installing the package also installs two command line tools:

bfl2csv /path/to/LOG00001.BFL              # writes CSVs next to the log (shorthand for log.outputCsv())
bfl2csv /path/to/LOG00001.BFL -u si        # SI units instead of raw
bfl2csv --help
bfl2rerun --help                           # shorthand for log.addToRerun()

Errors and temporary files

  • If a log is corrupt or logId doesn't exist, IndiflightLog(...) raises RuntimeError, and the decoder's message is printed to stderr. Your Python session keeps running, so you can catch the error and continue, e.g. when you loop over a folder of logs.
  • Each IndiflightLog instance decodes into its own folder in the user cache directory (~/.cache/indiflight_logs/ on Linux, ~/Library/Caches/indiflight_logs/ on macOS), so several processes can parse logs at the same time. The folder is deleted when the object is garbage collected. Folders left behind by killed processes are deleted after 7 days.
  • Threads can create IndiflightLog objects too, but the C decoder handles one log at a time. Use processes if you want to decode in parallel.

Releasing

Bump version in pyproject.toml, then push a tag log-tools-v<version>. The GitHub workflow .github/workflows/log-tools-wheels.yml in the indiflight repo builds the wheels and uploads them to PyPI.

License

GPL-3.0-or-later, see LICENSE.

Metadata

Release files for indiflight-log-tools 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for indiflight-log-tools 0.6.0
File Size Uploaded Provenance Actions
indiflight_log_tools-0.6.0.tar.gz 95.0 kB With provenance Details for indiflight_log_tools-0.6.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for indiflight-log-tools 0.6.0
File Actions
indiflight_log_tools-0.6.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details for indiflight_log_tools-0.6.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
indiflight_log_tools-0.6.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64, Linux glibc 2.17+ ARM64 Details for indiflight_log_tools-0.6.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl
indiflight_log_tools-0.6.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for indiflight_log_tools-0.6.0-py3-none-macosx_11_0_arm64.whl
indiflight_log_tools-0.6.0-py3-none-macosx_10_13_x86_64.whl Python 3 none macOS 10.13+ x86-64 Details for indiflight_log_tools-0.6.0-py3-none-macosx_10_13_x86_64.whl

Total release size: 535.6 kB

Release files / indiflight_log_tools-0.6.0.tar.gz

Download URL indiflight_log_tools-0.6.0.tar.gz
Size 95.0 kB
Tags Source
SHA-256 checksum
How to use checksums
dd67b9b99226b01f6cf6dd4147d27c74d52abb059547232fc38659b20b0e87f3
BLAKE2b-256 checksum
How to use checksums
28ed6dda7a225db4fd99996d559e5b4dead403174a2cb006a171b2bc24d8ad4a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / indiflight_log_tools-0.6.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl

Download URL indiflight_log_tools-0.6.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
Size 143.7 kB
Tags Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
155eed6eee6f2b5ebf3d7f1cac41efad8e562a1e47dd1be424650f34853ecb6a
BLAKE2b-256 checksum
How to use checksums
f9be6d1b9d502a3829c3d68ce9c53ef43e8c9b977a8cca15e89e0425ad7ee0b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / indiflight_log_tools-0.6.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl

Download URL indiflight_log_tools-0.6.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl
Size 146.4 kB
Tags Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
6d331885a85028ecd49c3ba7d2a1a6285ee401adb760b585e443562393c182e8
BLAKE2b-256 checksum
How to use checksums
b4a52bcf1caf23be8e0523b9d63fbef3f4415cb9b112c77ec46f411b156ad98f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / indiflight_log_tools-0.6.0-py3-none-macosx_11_0_arm64.whl

Download URL indiflight_log_tools-0.6.0-py3-none-macosx_11_0_arm64.whl
Size 75.3 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
63c82bc5e57406a1e6e3b0ca4f888a0851ae2457fd32bbfbfe0c311e7d19f2d2
BLAKE2b-256 checksum
How to use checksums
a4951f7334d57a4b71977d7b88d3c202dc529455386a5241e3781963d0d7505d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / indiflight_log_tools-0.6.0-py3-none-macosx_10_13_x86_64.whl

Download URL indiflight_log_tools-0.6.0-py3-none-macosx_10_13_x86_64.whl
Size 75.1 kB
Tags Python 3 macOS 10.13+ x86-64
SHA-256 checksum
How to use checksums
566ae47403f5616cf0b9a3991547ad6f7883bdb8910a63fa00329cfb63a8950a
BLAKE2b-256 checksum
How to use checksums
8de61a6ac931665597d429a50f7c6dccc962a7f274969f5d667d83324dac367d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Security for indiflight-log-tools 0.6.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 5 files in this release have been uploaded with provenance metadata.

Select from 5 files

Attestation for indiflight_log_tools-0.6.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page