How do Betaflight TX Lua scripts compare to using the Betaflight Configurator on a computer?

The Lua scripts offer field convenience without a computer but have a limited interface and depend on telemetry. The Configurator provides a full GUI with advanced features like firmware flashing, which the scripts lack.

How to install the Lua scripts on an EdgeTX transmitter?

Download the latest release zip, extract it, and copy the 'obj' folder contents to your SD card so files merge into the SCRIPTS directory. Verify bf.lua is in /SCRIPTS/TOOLS, as shown in the install GIF.

Does Betaflight TX Lua work with all FrSky receivers?

It supports FrSky receivers with SmartPort, but firmware updates are recommended to fix telemetry bugs. Some older or non-SmartPort receivers won't work, per the requirements list.

Why can't I access the CMS menu with my ExpressLRS setup?

The CMS menu feature is only available for TBS Crossfire/Tracer due to protocol-specific telemetry capabilities. With ExpressLRS, you can use the Betaflight setup script but not the CMS menu.

What happens if telemetry drops while using the script?

The script will lose communication with the flight controller, preventing configuration changes until telemetry is restored. This reliance on stable telemetry is a key limitation for field use.

How to update VTX tables after changing them in Betaflight Configurator?

In the Lua script, long press ENTER to open the function menu and select 'vtx tables' to reload the updated table. Downloading can take time based on table size and telemetry protocol.

betaflight-tx-lua-scripts

GPL-3.0Lua1.8.0

A collection of Lua scripts to configure Betaflight flight controllers directly from OpenTX/EdgeTX transmitters.

GitHub

What is betaflight-tx-lua-scripts?

Betaflight TX Lua Scripts is a collection of Lua scripts that allow drone pilots to configure Betaflight flight controller settings directly from their OpenTX or EdgeTX radio transmitters. It eliminates the need for a computer by enabling on-the-fly adjustments to parameters, VTX tables, and OSD menus via telemetry. The project solves the problem of field configuration and quick tuning without disconnecting from the flight controller.

Target Audience

FPV drone pilots and enthusiasts who use Betaflight flight controllers with OpenTX or EdgeTX transmitters and want to configure settings without a computer. It's particularly useful for racers and freestyle pilots who need to make adjustments at the flying field.

Value Proposition

Developers choose this project because it provides a seamless, integrated configuration experience directly from the transmitter, supports multiple telemetry protocols, and is officially associated with the Betaflight ecosystem. Its unique selling point is the ability to manage VTX tables and access the CMS menu without additional hardware.

Overview

Collection of scripts to configure Betaflight from your TX (currently only supported in OpenTx)

Use Cases

Best For

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

709 stars165 forks0 contributors

Configuring Betaflight flight controller settings in the field without a computer

Managing VTX tables for SmartAudio or Tramp video transmitters via transmitter

Accessing the Betaflight OSD CMS menu from a TBS Crossfire/Tracer transmitter

Synchronizing RTC and providing RSSI via MSP through a background script

Making quick tuning adjustments to drone parameters during flying sessions

Using ExpressLRS, Crossfire, or FrSky telemetry for Betaflight configuration

Not Ideal For

Pilots using flight controllers other than Betaflight (e.g., iNAV or KISS) since the scripts rely on Betaflight's MSP protocol.
Users with transmitters running outdated OpenTX (<2.3.12) or EdgeTX (<2.4.0) firmware that lack required Lua support.
Scenarios requiring full OSD CMS menu access without TBS Crossfire/Tracer equipment, as this feature is protocol-restricted.
Projects prioritizing plug-and-play simplicity, due to the need for precise telemetry setup and version compatibility checks.

Pros & Cons

Pros

Field Configuration Freedom

Enables adjusting Betaflight settings like PID tunes and rates directly from the transmitter without a computer, as shown in the Betaflight setup demo GIF.

VTX Table Management

Allows downloading and updating VTX tables for SmartAudio or Tramp VTXs via telemetry, with a dedicated function menu option as illustrated in the VTX table GIF.

Multi-Protocol Telemetry Support

Works with ExpressLRS, TBS Crossfire/Tracer, FrSky SmartPort, and ImmersionRC Ghost, detailed in the requirements section for broad compatibility.

Optional Background Utilities

Provides RTC synchronization and RSSI via MSP through a background script, useful when no other RSSI source is present, as explained in the background script setup.

Cons

CMS Menu Protocol Lock

Access to the Betaflight OSD CMS menu is exclusive to TBS Crossfire/Tracer users, leaving ExpressLRS or FrSky pilots with limited functionality, as explicitly stated in the CMS section.

Firmware Version Fragility

Requires specific firmware versions for Betaflight, transmitters, and receivers (e.g., ExpressLRS 2.0.1+), with issues like telemetry bugs in older FrSky firmware, complicating setup.

Installation and Compile Hurdles

Demands careful installation to avoid SD card errors and includes a compile step on first launch, which can fail if dependencies aren't met, adding friction for casual users.

Frequently Asked Questions

Home

Flying FPV

MAVlink

Marshalling / communication library for drones.

Stars2,275

Forks2,181

Last commit2 days ago

OpenLog

Open Source Hardware Datalogger

Stars593

Forks229

Last commit17 days ago

PID-Analyzer

PID-Analyzer is a Python-based tool that reads Betaflight blackbox logs and calculates PID step responses to provide a systematic approach to tuning quadcopter flight controllers. It helps pilots visualize how their PID settings affect flight performance by mathematically deriving the system response from input (PID commands) and output (gyro data). ## Key Features - **Blackbox Log Analysis** — Reads Betaflight blackbox logs using blackbox_decode.exe to extract flight data. - **PID Step Response Calculation** — Computes the system response via deconvolution to evaluate PID performance. - **Weighted Response Functions** — Reduces impact of external disturbances (e.g., wind) by weighting responses based on RC-input and quality. - **Dual Response for High Inputs** — Calculates separate responses for inputs above and below 500 deg/s when D Setpoint Transition is enabled. - **Throttle and TPA Visualization** — Plots throttle and TPA thresholds to account for dynamic PID changes during aggressive maneuvers. - **Cross-Platform Support** — Tested on Windows 7/10 and macOS 10.10 with Betaflight 3.15/3.2/3.3 logs. ## Philosophy PID-Analyzer aims to replace guesswork in PID tuning with a data-driven, mathematical approach, making it easier for pilots to achieve stable and responsive flight characteristics.

Stars419

Forks117

Last commit5 years ago