Repository navigation
Display widgets
The display of the device normally shows what the knobs and the footswitches are bound to. With display widgets a plugin can draw on the display too: a level meter above a knob, the state of a looper above a footswitch, a waveform on the whole screen.
You decide where each widget goes, page by page and subpage by subpage. The knobs and the footswitches keep working as usual: only what is drawn on the display changes.
A widget is something a plugin can draw on the display. Not every plugin has widgets: the plugin has to declare them (see For developers). A plugin can offer several widgets, for example a meter and a waveform, and you choose which ones to show.
Every widget says how much room it needs. It is offered only in the areas of the display where it fits:
| Area on the Dwarf | Size (pixels) |
|---|---|
| Column 1, 2 or 3, above a knob | 40 × 37 |
| Columns 1–2 or 2–3 | 82 × 37 |
| Columns 1–3 | 124 × 37 |
| Footer B or C, above a footswitch | 51 × 10 (footer B is 53 wide) |
| Footers B–C | 104 × 10 |
| Full screen | 128 × 64 |
The footers do not change with the subpage: a widget placed on a footer is shown on every subpage of its page.
Some widgets also suggest ports to bind: a widget that draws "STOP ALL" would like its Stop port on a footswitch. When you place the widget, the dialog offers these bindings, and you can change or refuse them. Widgets and bindings stay independent: a widget can sit above any control, and removing a widget leaves its bindings where they are.
Load a pedalboard with at least one plugin that has widgets, then open Device → Display on the constructor toolbar (the Device menu also holds the usual Bindings).

The dialog, Device Display, has two sides:
- on the left the widgets of the pedalboard
- on the right the page in view: a drawing of the display with its areas and, below it, the controls of the device with what they are bound to on that page

Each row shows the widget name and where it is placed (page, subpage, area), or Not on the display. When the
widget suggests ports, the row also says how many are bound, for example 1/2 ports bound. A widget placed in
more than one area shows the first one, followed by +1, +2...
Search widget or plugin: to filter the list by name
Placeable only: to hide the widgets that fit no free area (checked by default)
Flat / By plugin: to list the widgets alphabetically, or grouped by plugin. Two instances of the same plugin are told apart by their instance name
Click a widget to select it, click it again to deselect it.
Page: to choose the page in view, 1 to 8
Subpage 1, 2, 3: to choose the subpage in view
The drawing shows the areas of the display: the free ones with their names, the taken ones with the name of the widget they show. Clicking a taken area selects its widget.
- Select the widget in the list. The band above the drawing reads Place: with the widget name, its plugin
and the size it needs, for example
At least 16 × 8 px · looks best at 40 × 37 px. - Choose the page and the subpage.
- Click the cells of the drawing. The cells you can use are lit; the ones of the area closest to the widget size are preselected. Each click adds a cell to the selection or takes it out: clicking Column 1 then Column 2 picks Columns 1–2. For the full screen, click the background of the drawing, or its Full screen label.
- The line under the drawing confirms the area and its size, for example
Level · Column 1 · 40 × 37 px. A selection that matches no area, or an area too small for the widget, is reported there and cannot be used.
The same widget can be placed in more than one area: placing it again adds a new placement and never moves the other ones.
When the widget suggests ports, they are listed in the band as chips: the port name, then where it is bound, or
knob, not bound / switch, not bound.
Below the drawing, Controls · Page N shows the knobs and the footswitches of the page in view:
| Control | Meaning |
|---|---|
| a port name | bound to another parameter: it cannot be used |
Free |
free: click it to bind a port of the selected widget there. With more ports that fit, a menu lets you choose |
a port name with on Save
|
bound by the dialog to a port of this widget, applied when you save. Click it and Unassign to free it |
Switch ports (toggles and triggers) go to footswitches, the other ones to knobs. A port that is already bound is shown where it is and left alone.

Assign automatically does it all for you: it chooses the page, the area closest to the widget size and the controls for its suggested ports, nearest to the widget first.
Nothing is applied yet: the band reads Proposal: with the page and the area, and the proposed controls are
marked proposed.

Accept: to take the proposal
Discard: to drop it
When there are not enough free controls, the ports that found no room are listed as not bound.
Click the trash icon in the corner of its area, or the trash icon in the band to remove the selected widget. Only the widget is removed: its bindings stay.
Save: to apply the bindings first, then the widget layout. The display of the device changes immediately. If a binding fails, an error says so, and the layout is saved anyway.
Cancel: to close the dialog and leave everything as it was
The layout is saved with the pedalboard. The dialog changes the pedalboard in memory: save the pedalboard to keep the widgets where you placed them. Loading the pedalboard places them again.
Widgets that no longer fit are dropped when the pedalboard is loaded: a plugin that was removed, a widget the plugin no longer offers, an area the device does not have.
Menus, overlays and the tuner can cover a widget: when they close, the widget is drawn again.
On the MOD Duo X the dialog shows the two displays side by side, each with its own areas and, below it, the controls it shows. The Duo X draws the widgets on both displays since Starless 19.
Widgets are an LV2 extension: a plugin declares its widgets in its TTL and draws them with a small C API. The specification, a tutorial and two example plugins (a meter and a demo with widgets of every size, from a footer to a brick breaker game on the full screen) are in the alabs-hmi-widgets repository.