# Widgets

{% hint style="info" %}
After a widget has been setup, long pressing on the widget will give you the two menu options: **Full screen** and **Widget** settings. For some widgets, full-screen mode will offer additional functionality. To exit out of full-screen mode, long-press the RTN / Back button.
{% endhint %}

Below are descriptions and configuration options for widgets included with EdgeTX.

### BattAnalog

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-09c5050acc454359c25b8fee41e182ae9a40d0b7%2Fwid_battanal.png?alt=media" alt=""><figcaption><p>BattAnalog Widget</p></figcaption></figure>

Displays a graphical representation of the charge level of a Lipo/Li-ion. It will automatically detect the cell count of the battery. It works with telemetry where only the total battery voltage is received. The configurable options are:

* **Sensor** - Sensor for the battery voltage to use.
* **Color** - Opens the color picker to choose the color for the text.
* **Show\_Total\_Voltage** - Shows total battery voltage (instead of calculated cell voltage) when enabled.
* **Lithium\_Ion** - Adjusts the minumum battery voltage used in calculating the remaining battery percentage from 3.0 to 2.8 when enabled.

### BattCheck

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-413cf39d496bbf628f716c4c30da0dffc80842c3%2Fwid_battcheck.png?alt=media" alt=""><figcaption><p>BattCheck Widget</p></figcaption></figure>

Displays a graphical representation of the charge level of a Lipo/Li-ion. It works with telemetry where individual cell voltage is received, such as FLVSS liPo Voltage Sensor. The configurable options are:

* **Sensor** - Sensor for the battery voltage to use.
* **Color** - Opens the color picker to choose the color for the text.
* **Shadow** - When enabled, adds a shadow to the text.
* **LowestCell** - When enabled, shows only the voltage of the lowest cell (vs. showing all cell voltages).
* **Lithium\_Ion** - Adjusts the minimum battery voltage used in calculating the remaining battery percentage from 3.0 to 2.8 when enabled.

### Counter

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-2b9ea5a62d606d957cb9e16f2e816d46c90c33dd%2Fwid_counter.png?alt=media" alt=""><figcaption><p>Counter Widget</p></figcaption></figure>

A counter that incrementally counts. The configurable options are:

* **Color** - Opens the color picker to choose the color for the text.
* **Shadow** - When enabled, adds a shadow to the text.

### **Event Demo**

<div><figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-facd8aa8f30346f44de5f3cd57487f263d4818ba%2Fwidgets5.jpg?alt=media" alt=""><figcaption><p>Counter and Event Demo Widgets</p></figcaption></figure> <figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-b6d4bfe3dc2a2c6d9cfa74e16be58ce3c6ff72ac%2Fwidgets6.jpg?alt=media" alt=""><figcaption><p>Event Demo Widget Full Screen</p></figcaption></figure></div>

Demonstrates handling of key and touch events in full screen mode. For demo purposed only. The configurable options are:

* **Size** - Changes the size of the box in full screen mode.

### **Flights**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-b02e32c34c8698856069120d0c23cf690177a4cc%2Fwid_flights.png?alt=media" alt=""><figcaption><p>Flights Widget</p></figcaption></figure>

Counts your number of flights. It will give you a verbal queue when the flight has started, finished as well as the total flights for the model.

The configurable options are:

* **switch** - Designated Arm/Safe switch.
* **motor\_channel** - Channel for the motor.
* **min\_flight\_duration** - Minimum flight duration for the flight to be counted.
* **text\_color** - Opens the color picker to choose the color for the text.
* **debug** - When enabled, shows status information on the widget.

_**Additional notes regarding this widget:**_

The flight is considered successful if after 30sec the engine is above 25%, telemetry is active (to indicated that the model connected), and safe switch ON. The flight is considered ended after 8 seconds of battery disconnection (detected by no telemetry) -- warning: do NOT use this widget if model is using GV9 (GV9 FM0 is where the flight count is stored)!

The widget assumes the following: the model has a motor, the motor is activated on channel 3 (can be configured in settings), there is telemetry with one of the above \[RSSI|RxBt|A1|A2|1RSS|2RSS|RQly], there is a safe switch (arm switch), and global variable GV9 is free (i.e. not used).

### Gauge

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-23487b3773880a30c965e6ee29e20faab2f7070a%2Fwid_gauge.png?alt=media" alt=""><figcaption><p>Gauge Widget</p></figcaption></figure>

Shows a bar graph for the source value. The configurable options are:

* **Source** - Source for the gauge.
* **Min** - Minimum value for the gauge. This value will be 0%
* **Max** - Maximum value for the gauge. This value will be 100%
* **Color** - Opens the color picker to choose the color for the gauge text and bar.

### **Gauge Rotary**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-b1bc29b6825c04e8f6dcd5c0e07ffcaabfc9458a%2Fwid_gaugerotary.png?alt=media" alt=""><figcaption><p>Gauge Rotary Widget</p></figcaption></figure>

A configurable analog style gauge with a needle. Also shows the minimum and maximum values that were read by the gauge with green and red needles. The configurable options are:

* **Source** - Source for the gauge.
* **Min** - The minimum (lowest) gauge value.
* **Max** - The maximum (highest) gauge value.
* **HighasGreen** - **Enable** for a sensor where high values are good. **Disable** for sensor where low values are good.
* **Precision** - The precision of the number value to display in decimals.

### **Ghost**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-802388a90d007c3501e313994350a7272efe6ef8%2Fwid_ghost.jpg?alt=media" alt=""><figcaption><p>Ghost Widget Normal Mode and VTX Mode</p></figcaption></figure>

The Ghost widget will display RF receiver or video transmitter telemetry data based on the mode that is configured.

In normal mode, the widget provides RF Mode (RFMD), Frame Rate (FRATE), Link Quality (RQLY), and Transmit Power (TPWR)

In video mode, the widget provides Video Band (VBAN), Video Frequency (VFRQ), Video channel (VCHAN), and Video Power (VPWR)

### **LibGUI Demo**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-9652aa8591fcb5434410771e81fb347915a3729d%2Fwid_libgui.jpg?alt=media" alt=""><figcaption><p>LibGUI Demo Widget</p></figcaption></figure>

This widget is a demo for the LibGUI library. This library is not normally run by itself. Instead, it provides interactive functions to other Lua scripts that use it. The widget must be run in full-screen mode to demo the library's functionality.

### **Model info**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-83c3ed56f9ea3aa8a1e467e6d3073ad518ee319e%2Fwid_modelinfo.png?alt=media" alt=""><figcaption><p>Model Info Widget</p></figcaption></figure>

Displays the selected model name and picture (if configured in model settings). The configurable options are:

* **Color** - Opens the color picker to choose the color for the name text.
* **Size** - Size for the name text. Options are STD (Default), BOLD, XXS, XS, L, XL, XXL
* **Fill background?** - Adds a solid background color to the widget when enabled
* **BG Color** - Opens the color picker to choose the color for the background.
* **Use Theme Color** - When enabled, overrides the text color with the text color of the configured theme.

### **Outputs**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-b02652c7c0d2597ada8a8248e721c6e364a47ff4%2Fwid_outputs.png?alt=media" alt=""><figcaption><p>Outputs Widget</p></figcaption></figure>

Shows the channel output values in a bar graph. The number of channels that are displayed is dependent on the size of the widget. The configurable options are:

* **First channel** - selects the first channel to display in the widget.
* **Fill background** - Adds a solid background color to the widget when enabled
* **BG Color** - Opens the color picker to choose the color for the background.
* **Text Color** - Opens the color picker to choose the color for the text.
* **Color** - Opens the color picker to choose the color for the output bars.

### Serial Power Port Demo

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-3f48fb9c6c33c789627aa0706afe94855c36d0a3%2Fwid_serialpower.png?alt=media" alt=""><figcaption><p>Serial Power Port Demo Widget</p></figcaption></figure>

A demo widget to show you how the power port can be used. It must be run in full screen mode.

### **SOARETX**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-5c715a8e46ecc5853b2e761cdedaf10c4d60b7aa%2Fwid_soaretx.jpg?alt=media" alt=""><figcaption><p>SoarETX Widget</p></figcaption></figure>

The EdgeTX version of the SoarOTX tool. It is a package of sailplane models for EdgeTX transmitters. It provides Lua scripts for timing and scorekeeping, graphing of log data (e.g. altitude graphs), and model configuration.

For more information about the configuration and use of this widget please see [https://github.com/jfrickmann/SoarOTX/wiki/SoarETX-for-color-radios](https://github.com/jfrickmann/SoarOTX/wiki/SoarETX-for-color-radios).

A demo of this tool can be seen here: [https://www.youtube.com/watch?v=5NSvxUNKM\_c](https://www.youtube.com/watch?v=5NSvxUNKM_c)

### **Text**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-845e446f5b69e5c87677201ee9f5bf0ce8f59ef7%2Fwid_text.png?alt=media" alt=""><figcaption><p>Text Widget</p></figcaption></figure>

Displays a user-customizable text field. The configurable options are:

* **Text** - Text to display
* **Color** - Opens the color picker to choose the color for the text.
* **Size** - Size for the text. Options are STD (Default), BOLD, XXS, XS, L, XL, XXL
* **Shadow** - When enabled, adds a shadow to the text.

### **Timer**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-89935c793a361ca7e4f6eca1204b84df0e9d1c92%2Fwid_timer.png?alt=media" alt=""><figcaption><p>Timer Widget</p></figcaption></figure>

Displays the selected timer. No configurable options other than timer selection.

### **Timer2**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-1570e3184b52b38101be4318c8e0de79986c7d9f%2Fwid_timer2.png?alt=media" alt=""><figcaption><p>Timer2 Widget</p></figcaption></figure>

Displays the selected timer with the timer text scaled based on the select widget size and has the following configuration options:

* **TextColor** - Opens the color picker to choose the color for the text.
* **Timer** - Timer to display.
* **use\_days** - Shows days when the time value is over 24 hours when enabled.

### **TxGPStest**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-a329e449ef41cca5af641cbb4ffb5331f969d7d1%2Fwid_gpstest.png?alt=media" alt=""><figcaption><p>TxGPSTest Widget</p></figcaption></figure>

Displays GPS Information in text format. There are no configurable options.

### **Value**

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-f1855d9f067f4ab6fa9ecff78620b8e68903f868%2Fwid_value%20(1).png?alt=media" alt=""><figcaption><p>Value Widget</p></figcaption></figure>

Displays a numeric value of the defined source as text. The configurable options are:

* **Source** - source for the text to be displayed
* **Color** - Opens the color picker to choose the color for the text. User can choose between RGB and HSV color model to choose the color. You can also select one of the configured theme system colors.
* **Shadow** - When enabled, adds a shadow to the text.
* **Align Label** - Aligns the label text. Options include: **Left**, **Center**, **Right**
* **Align Value** - Aligns the value text. Options include: **Left**, **Center**, **Right**

### Value2

<figure><img src="https://1252429118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc6eINXoIlfUG72tlmns6%2Fuploads%2Fgit-blob-5d0fdab823fbec4d5a1f0ff0f36097dee3c0b892%2Fwid_value2.png?alt=media" alt=""><figcaption><p>Value2 Widget</p></figcaption></figure>

Displays a numeric value of the defined telemetry source as text. The text will scale based on the size of the widget grid that is selected. The widget will detect the end of the flight (by no longer receiving telemtry) and will then display the min and max values of the configured telemetry sensor.

The configurable options are:

* **Source** - Telemetry source for the text to be displayed
* **Color** - Opens the color picker to choose the color for the text. User can choose between RGB and HSV color model to choose the color. You can also select one of the configured theme system colors.
* **PostFix** - Appends a text label after the configured telemetry name label.
