August 12, 2026
by Garykk

How to Install and Run ELRS Lua Script on EdgeTX Radios

August 12, 2026
by Garykk

The ExpressLRS Lua script allows you to change ELRS settings (power level, packet rate, binding mode) directly on your radio screen without plugging into a computer.

How to Install and Run ELRS Lua Script on EdgeTX Radios matters because the radio link is the part of an FPV build you trust every second of a flight. A good choice feels invisible: sticks respond cleanly, telemetry is readable, and the aircraft does exactly what the selected model profile expects.

Step-by-step Setup

Download the elrsV3.lua script file from the official ExpressLRS GitHub or Configurator.

Insert your radio's MicroSD card into your computer.

Place elrsV3.lua inside the SD Card / SCRIPTS / TOOLS directory.

Reinsert MicroSD card into radio and turn on power.

On the receiver side, match the aircraft and antenna plan before flashing. A small freestyle build usually fits the 2.4G Nano ExpressLRS receiver, while long-range builds may justify the 915M Nano ExpressLRS receiver and more careful antenna placement.

Bench Workflow

Back up your radio model before changing RF, scripts, or gimbal settings.
Change one variable at a time, then test in the receiver tab or simulator.
Keep props off during all radio, receiver, and firmware checks.
Record the final setting so the next repair does not start from memory.

Practical Takeaway

How to Install and Run ELRS Lua Script on EdgeTX Radios should make your FPV setup easier to trust, not more complicated. Use the plan above as a field decision tool: choose the hardware or setting that reduces failure points, test it on the bench, then verify it in a controlled first flight.

What the Lua Script Is For

The ELRS Lua script is the radio-side control panel for many important link settings. Instead of connecting the module to a computer every time, you can adjust packet rate, output power, dynamic power, Wi-Fi mode, and binding behavior directly from the EdgeTX radio.

That makes the script part of your normal field toolkit. If you fly multiple aircraft, it lets you confirm the radio module is responding before you waste time troubleshooting the drone.

Installing It Correctly

The usual process is to download the correct Lua script from the ExpressLRS release or configurator resources, copy it to the radio SD card, and access it from the Tools menu. The exact folder can vary by radio setup, so use the EdgeTX file structure rather than guessing.

If the script opens but cannot communicate with the module, check that the module is powered, the model is using the correct RF mode, and the radio firmware is compatible. A missing or outdated script can also create confusing behavior after a major ELRS update.

Field Uses

At the field, the Lua script is useful for confirming packet rate, checking output power, enabling Wi-Fi mode for updates, and verifying that the module is alive. It is also a quick way to notice if the wrong model profile is selected before powering the drone.

Do not make several setting changes at once before a flight. Change one item, test close, then continue. Radio-link changes deserve the same caution as PID, filter, or motor-output changes.

Maintenance Habit

Keep a known-good copy of the script on your computer. When updating ELRS, update the script at the same time. That small habit prevents version mismatch problems where the radio works but the menu no longer exposes the options you expect.

Version Matching the Script

The Lua script should match the ELRS generation you are using. After a major ELRS update, an old script may open but fail to show the right options or communicate reliably with the module. When you update firmware, update the script as part of the same maintenance session.

Keep the SD card organized. Random duplicate scripts with similar names can make it unclear which one you are running. Delete old copies or move them into a backup folder when you know the new script works.

Using Wi-Fi Mode From the Radio

One useful field trick is enabling Wi-Fi mode from the Lua script. That can let you connect to a module or receiver for updates without unplugging hardware. It is especially helpful when a receiver is buried inside a compact build.

Do this with the aircraft secure and props removed. Wi-Fi update work is bench work, not something to do beside an armed aircraft. After the update, power-cycle and verify receiver movement again.

Common Script Mistakes

If the script file is in the wrong folder, it may not appear in the radio tools menu. If the file is outdated, it may appear but not control the module correctly. If the model profile uses the wrong RF mode, the script may look broken even though the file is fine. Work through those causes in order before reflashing hardware.

Why This Matters at the Field

The Lua script is often the fastest way to confirm that the radio module is alive before blaming a receiver. When a drone does not connect, checking the script first can separate a module problem from an aircraft problem. That saves time and avoids unnecessary disassembly.