Documentation

1. Open the Brokers tab (bottom menu)
2. Tap the + button in the top right corner
3. Fill in the required fields:
   • Name — any name (e.g., "Home Server")
   • URL — broker IP address or domain
   • Port — port (1883 for TCP, 8883 for SSL)
   • Protocol — select tcp://, ssl://, ws:// or wss://
4. Optionally enable Authentication and enter username/password
5. Configure additional parameters (Client ID, Clean Session, Keep Alive Interval, Auto Connect)
6. Tap Done

The first address is set when you create a broker. To add more, open the broker editor and tap Add endpoint.

1. Host — IP address or domain
2. Protocol — tcp://, ssl://, ws:// or wss://
3. Port — connection port
4. SSL — for ssl:///wss://: self-signed certificate or a custom CA certificate file

Additional settings:

• Priority — High / Medium / Low. Higher priority addresses are tried first.
• Network Scope — for which networks the address is suitable: Any / Wi-Fi only / Cellular only.
• Enabled — disabled addresses are not used. Toggle it, or delete the address, from the menu on the endpoint screen.

• When connecting, the app tries enabled addresses in priority order (High → Medium → Low)
• If an address fails, it automatically switches to the next one
• After all addresses fail, the pause between attempts grows (2 s → 4 s → … → 60 s)
• When the network changes (Wi-Fi ↔ cellular), the selection restarts from the highest-priority address
• The broker card shows the active address and per-address errors
• At least one address must be enabled
• Endpoint addresses are included when you back up and restore your data

1. On the main screen, tap the + button in the bottom right corner and choose Create Widget
2. Enter the Widget Name and select a Group to add it to
3. Choose the number of parameters (1 to 4) using the horizontal pager — each parameter can have its own type, topic and settings
4. Tap a parameter in the list to configure its type, topics and data processing — see the Widget Parameter Configuration section for details
5. Tap Done to complete creation

• Drag and Drop: long-press a widget and drag it to a new location. Empty cells are highlighted.
• Context Menu: long-press a widget to open the menu (Edit, Delete)
• Editing: tap a widget to open detailed info and settings
• Changing the group: open the widget for editing and pick another Widget Group
• Lock: long press can be turned off entirely — see Lock Home screen

• Name and Data type are the first card on the screen. The type is picked in a bottom sheet: every type comes with a live preview — exactly what will appear on the tile — and a short description of what it does.
• Icon — the icon and color of the parameter, chosen in the Icon and color dialog. For Binary and Button the appearance is set separately for the on and off states; for Switch and Dropdown list it is set per state in the list of states.
• Topics, data processing and the remaining settings depend on the selected type — see the descriptions below.

Extracts a value from a JSON message.

Supports dot notation ($.object.array[0].value) and bracket notation ($[\'store\'][\'book\'][0][\'title\']).

Extracts data using regular expressions. Works as a second stage after JsonPath.

Three-step pipeline:

1. JsonPath → extract field from JSON
2. Regex (primary) → extract data from string
3. Regex (secondary) → post-process the result

Regex Time — separate expression for extracting a timestamp from the payload.

Extracts a timestamp from a separate JSON field.

• Specify a JsonPath to the time field
• Time zone correction — slider from -12 to +12
• Supports various date/time formats

1. Open the Groups tab (bottom menu) and tap + in the top right corner — or tap + on the main screen and choose Create Group
2. Enter the group Name and tap Done
3. To move a widget to another group, open the widget for editing and pick the desired Widget Group

On the main screen, groups are shown as section headers: tapping a header collapses or expands the group. On the Groups tab the list can be sorted manually, by name, or by widget count.

1. Open the Scripts tab (bottom menu)
2. Tap + in the top right corner and choose Create Script
3. Configure the triggers:
   • Widget — fires on the value of a selected widget parameter: equals, not equals, greater than, less than. The topic comes from that parameter's own settings
   • App Start — runs when the application starts or returns to the screen
   • Logical Block — combines several conditions
4. A Logical Block supports the operators AND, OR, NOT ANY and NOT ALL; blocks can be nested
5. Configure actions:
   • Widget — Send Message through a widget parameter, or Blink Widget in a chosen color
   • Push notification — show a notification with your own text
   • Play sound PREMIUM — a system sound or your own audio file
6. Enable the script — toggle switch on the script card. Disabled scripts won't execute but remain editable

A disabled script can be opened and edited — changes are saved and take effect when the script is re-enabled.

1. Open the Scripts tab (bottom menu)
2. Tap + in the top right corner and choose Create Scene
3. Enter the scene Name and the Widget Group it belongs to
4. For the "On" state pick an icon and a color, then add actions under Messages for "On"
5. Configure the "Off" state the same way
6. Tap Done

A scene does not work with raw topics — it works with widgets you have already configured, so the topic, QoS and prefix/suffix come from the widget parameter. You therefore need at least one widget before creating a scene.

1. Tap + in the message list you want
2. Select the Widget Group
3. Select the Widget
4. Select the widget Parameter
5. Enter the Send Value — for switches, dropdown lists, buttons and regulators, suggestions from the parameter settings are offered
6. Tap Done

A finished scene appears on the Scripts tab as a switch. Turning it on sends every message from the "On" list; turning it off sends the "Off" list. The icon and color change with the state.

1. Settings → Configuration Backup
2. Optionally enable data logs (sensor value history)
3. Tap Create and choose a save location

1. Settings → Share configurations over MQTT → Export configuration
2. Optionally enter a configuration name
3. Choose what to include: Scenes, Scripts and Broker credentials (the latter requires an encryption password)
4. Optionally set an encryption password and the config storage period (1, 3, 7, 14 or 30 days; default 7)
5. Select a broker and tap Publish

The configuration is published to the topic {prefix}/{id} and stored on the broker. Without a password, data is only compressed (not encrypted), and broker credentials are not included.

1. Settings → Share configurations over MQTT
2. Enable Receive configurations — the app subscribes to {prefix}/+ (default config/share/+)
3. Received configurations appear as cards with View details (what will change), Apply and Decline

Import modes:

• Merge — update existing items and add new ones
• Replace all — remove current widgets, groups, scenes and scripts and import new ones. Requires a second confirmation with a checkbox.

If a configuration is password-protected, you will be asked for the password during import. Brokers with authorization will ask for login and password. After a successful decryption, you can save the password so it is applied automatically to future configurations.

• Theme — System, Light or Dark. By default the app follows the device theme.
• Language — the language of the app interface. System uses the device language.

Settings → Interface → Home screen → Lock Home screen. Off by default.

With the lock on, a long press on a widget does nothing: no context menu, no haptic feedback, no dragging. The layout cannot be broken by accident — useful on a shared or wall-mounted tablet.

• Taps keep working as usual: switches, buttons, regulators and dropdown lists still control your devices
• The lock also applies inside a widget group
• Editing, cloning and deleting remain available the usual way: tap the widget → widget screen → the action you need

Settings → Interface → Home screen. Seven sizes, each configured separately:

• Widget Size — the size of the tile on the Home screen
• Value (Text) — the font of the parameter value
• Widget Name — the font of the widget label
• Last Message Time — the font of the timestamp
• Parameter Icon — the icon size
• Value — only for the Binary and Color types
• Button — only for the Button type

Each item opens a screen with a slider and a preview of the Home screen, so changes are visible right away on your own widgets. Auto means the app picks the size itself; a value you set manually is shown in dp next to the setting name.