Add lvgl bindphrase setting script

[CapnBry]

For ExpressLRS 4.1, a utility to set a bindphrase. Builds on #3

There is a history saved to "elrs-phrase.txt" that shows last 5 as buttons the user can click to set the bindphrase to that but holy smokes if after 3 hours I could not get it to work. There's no way to set a textEdit's value?! Deleting it and recreating it lets me update it, but then the button just doesn't do anything. No error. Nothing. 🤷 Whatever EDIT: I sort of hamfisted got it working

RX Binding Functions

If there is no RX connected and the user selects the "Receiver" target, the user is presented with instructions and a Bind button. If an RX is connected when receiver is selected, an "Unbind" button is added to allow them to disconnect it and allow it to bind to someone else. Image below.

Zip file for users who want to use this now

Includes this entire repo with Jurg's scripts as well, unzip to the root of your SD card

elrs-bind-v5.zip

[CapnBry]

• Renamed to "ELRS Bind Manager". Please delete elrs-phrase.lua, elrs-phrase.luac, and rename your elrs-phrase.txt to elrs-bind.txt after updating with v2 zip in first post.
• Updated to scale properly with LCD size

[CapnBry]

The language server test is dead wrong and it can fuck right off. I will now fight to have this check removed from check process. 😠

[robschii]

not working with edgtx 2.12.2!

[CapnBry]

not working with edgtx 2.12.2!

Which is the only version of EdgeTX I've tested it with! Maybe you can provide some other information about your setup? Handset, ELRS version, ELRS module type? Note that this only works on ELRS 4.1.0-RC1 currently.

[Larryvoll]

JUst a lil FYI, The GX12 has a 128×64 monochrome OLED, not a color touchscreen. LVGL-based Lua scripts (buttons, sliders, text fields, the whole "bind v2" UI style) were built specifically for EdgeTX's color-screen radios — EdgeTX 2.11 added that LVGL API, but only for the color-LCD firmware build. On the monochrome/B&W build (which is what your GX12 runs, even at 2.12.1), the lvgl object is never populated at all — it's compiled out, not "an older version." The script can't tell the difference between "firmware too old" and "hardware doesn't have LVGL," so it throws the same generic "2.11+ required" message either way.
Bottom line: no firmware upgrade will get this specific script working on the GX12. It's a hardware limitation, not a version mismatch. Probably true for all mono screens?

[charlybrown1982]

JUst a lil FYI, The GX12 has a 128×64 monochrome OLED, not a color touchscreen. LVGL-based Lua scripts (buttons, sliders, text fields, the whole "bind v2" UI style) were built specifically for EdgeTX's color-screen radios — EdgeTX 2.11 added that LVGL API, but only for the color-LCD firmware build. On the monochrome/B&W build (which is what your GX12 runs, even at 2.12.1), the lvgl object is never populated at all — it's compiled out, not "an older version." The script can't tell the difference between "firmware too old" and "hardware doesn't have LVGL," so it throws the same generic "2.11+ required" message either way. Bottom line: no firmware upgrade will get this specific script working on the GX12. It's a hardware limitation, not a version mismatch. Probably true for all mono screens?

Yes, I found the same issue with the Radiomaster Pocket.

[Ivan125976]

Hello! When launching on a Radiomaster Boxer running EdgeTX 2.11.6, a message appears at the top: "LVGL (EdgeTX 2.11+) requir...". The rest of the message extends off the screen.

[CapnBry]

Updated

• Added X to delete items from the History list
• Added "Both" target to set both the RX and TX at the same time
• Moved script to folder instead of at the root, allows for a ui subfolder and then the ability to render a B&W ui, however crippled that will be
• elrs-bind.txt (the saved history) renamed to history.txt

Updating

If you already have this installed, you'll need to delete the elrs-bind.lua, elrs-bind.luac, and move elrs-bind.txt to elrs-bind/history.txt if you want to preserve your history. Otherwise just delete elrs-bind.txt to let the new location start a new history.

[CapnBry]

Hello! When launching on a Radiomaster Boxer running EdgeTX 2.11.6, a message appears at the top: "LVGL (EdgeTX 2.11+) requir...". The rest of the message extends off the screen.

Hello and thanks for reporting this, but this should be reported in #3 as that's the base that displays this message and this builds on it.

[wimalopaan]

In elrs-bind-v4.zip you included a somewhat different version of @jurgelenas script: there are additional

• Phrase Echo
• Bind Phrase

fields at the bottom (see attached image).

What is the purpose of these fields?
Is this intentional or an left-over from some tests?

[CapnBry]

@wimalopaan Uhhhh is that in the simulator? The simulator is all fake fields and the source is the same as jurg's.

I just merged his latest but I have never seen those fields and they should only appear if the handset model ends in "-simu"

[wimalopaan]

@wimalopaan Uhhhh is that in the simulator? The simulator is all fake fields and the source is the same as jurg's.

I just merged his latest but I have never seen those fields and they should only appear if the handset model ends in "-simu"

Sure that is simulator.

I think the purpose of these fields are just to test the lastest features of the script, i.e. editing STRING parameter and editing FLOAT parameter.

I was suprised to see these fields at a position were for a real tx-module no fields are displayed.

Maybe they aren't needed anymore, since string editing is part of the elrs-bind-script now and the fake float field could be moved to the faked receivers page.

[CapnBry]

I'm not sure I'm following you. You were surprised to see fields for testing all the data types in the simulator? It's for testing all the field types. Also, is present in the PR this is based on so that's why it is here too and will also be present in master when all this gets merged.

[robschii]

not working with edgtx 2.12.2!

Which is the only version of EdgeTX I've tested it with! Maybe you can provide some other information about your setup? Handset, ELRS version, ELRS module type? Note that this only works on ELRS 4.1.0-RC1 currently.

radiomaster boxer on erls 4.1.0 is it not for boxer??

[CapnBry]

radiomaster boxer on erls 4.1.0 is it not for boxer??

The Boxer is a B&W screen so it does not support GUI applications. A B&W version will come later, so get ready to type out a passphrase using a scrollwheel like an animal.

[bd4]

Is this going to be closed in favor of the version that is now in #3?

[jurgelenas]

Is this going to be closed in favor of the version that is now in #3?

Potentially yes, but that version is much less tested and still waiting for @CapnBry approval. It has BW support as a bonus though!

[bd4]

Is this going to be closed in favor of the version that is now in #3?

Potentially yes, but that version is much less tested and still waiting for @CapnBry approval. It has BW support as a bonus though!

Thanks, I tested the BW support in #3, just what I was waiting for because I use the Pocket as a wireless trainer, with ELRS on a different bind phrase so it does not interfere with connection to plane. Worked for me.

[Larryvoll]

I downloaded the new tool, made sure everything was on ELRS 4.1, and it works great on my GX12 now! What a huge feature, thanks to all that built it.

…

On 2026-08-14 4:09 p.m., Bryce Allen wrote: *bd4* left a comment (ExpressLRS/Lua-Scripts#10) <#10 (comment)> Is this going to be closed in favor of the version that is now in #3 <#3>? Potentially yes, but that version is much less tested and still waiting for @CapnBry <https://github.com/CapnBry> approval. It has BW support as a bonus though! Thanks, I tested the BW support in #3 <#3>, just what I was waiting for because I use the Pocket as a wireless trainer, with ELRS on a different bind phrase so it does not interfere with connection to plane. Worked for me. — Reply to this email directly, view it on GitHub <#10?email_source=notifications&email_token=AR44KD32TGCIWLB3GSDTVK35J6E23A5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKMRZHA3DKNJTG4YKM4TFMFZW63VHMNXW23LFNZ2KKZLWMVXHJLDGN5XXIZLSL5RWY2LDNM#issuecomment-5298655370>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AR44KDZGOBH3CWQCQGJJSUL5J6E23AVCNFSNUABGKJSXA33TNF2G64TZHMYTCNJVGQYDQMBWGI5US43TOVSTWNBXGU2TINBRGU2DTILWAI>. Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/AR44KD6E6RIXDVQDL2M427T5J6E23A5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKMRZHA3DKNJTG4YKM4TFMFZW63VHMNXW23LFNZ2KKZLWMVXHJKTGN5XXIZLSL5UW64Y> and Android <https://github.com/notifications/mobile/android/AR44KD4QAN7KLRTMLMOVDT35J6E23A5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKMRZHA3DKNJTG4YKM4TFMFZW63VHMNXW23LFNZ2KKZLWMVXHJLTGN5XXIZLSL5QW4ZDSN5UWI>. Download it today! You are receiving this because you commented.Message ID: ***@***.***>