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.
• Parameter menu — in the widget editor, open the menu on a parameter: Clone creates a copy with the same settings (beyond four parameters a copy requires Premium)
• Topics, data processing and the remaining settings depend on the selected type — see the descriptions below.

The Ask before sending checkbox in the Sending section of the parameter editor makes the app ask for confirmation on every manual control action: on the Home screen, the widget screen, the parameter screen and the home screen widget.

• The value is sent only after Send; for a button, "pressed" and "released" also wait for confirmation
• Scripts, scenes and the terminal never ask for confirmation
• Without a subscription, an attempt to send offers to get Premium or to turn confirmation off — the value is not sent

On the details screen a text parameter shows the latest value by default. The Latest chip in the header of the text block switches the view to a feed of the 5, 10, 20 or 50 latest values.

• Show: incoming, outgoing or all — outgoing ones are marked "Sent"
• The chosen view is remembered for this parameter
• The feed is available for a single-widget parameter and for a parameter of a multi-widget alike

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.

In Settings → Interface → "Groups on the Home screen" you can switch to the "Chips" view: one group at a time, switched via chips at the top (including "All"). The "List" view keeps all groups in a row.

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.

A value-based condition has two extra fields:

• Holds for at least — the script fires only if the condition stays true for that long (up to 24 hours). Empty or 0 — fires immediately
• Reset at — the threshold after which the condition may fire again: for "greater than" it fires again only when the value drops below the threshold, for "less than" — when it rises above. Empty — fires again as soon as the condition stops being true

The settings are visible on the condition card itself: "holds for…", "reset at…".

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.

1. Settings → the Current home card → the Homes screen opens
2. Tap New home and enter a name
3. Optionally enable Add standard rooms — a living room, kitchen, bedroom and other groups are created at once
4. Tap a home in the list — it becomes current and the Home screen rebuilds

• Rename and Reorder — from the home's menu in the list
• Deleting a home removes its groups, widgets, scenes and scripts; home screen widgets based on them stop working. Brokers stay — they are shared
• Scripts and notifications work in every home, not only in the open one
• Homes take part in config sharing

1. Settings → Phone as a Device
2. Turn on Publish phone data
3. Under Where to send pick a broker — data goes only to that broker
4. Optionally set a Device name — the model name is used by default
5. Enable the Sensors you need: battery (level, charging, charger type, temperature), screen, power saving, sound (ringer mode and Do Not Disturb), network, storage, next alarm, app version
6. For Location, choose how often to send a point and grant location access "all the time" — otherwise no points are sent in the background
7. Enable Announce device to make the phone appear in the app's device discovery by itself

The topic the data is published to is shown on the screen — copy it for your automations.

• With background work on — immediately on every change. Background work keeps the phone awake and drains the battery noticeably
• Without it — about every 15 minutes, and less often while the phone is asleep
• Location points are sent at the chosen interval; with background work a point also goes out early when the phone has moved more than 50 m
• When publishing is turned off, the app clears its messages from the broker

1. Open Export history: in the terminal menu on the widget or parameter screen, or in the widget screen menu
2. Choose what to export:
   • Messages under the terminal filter — the broker, topics and search come from the terminal itself
   • Widget parameters — pick one or more parameters
3. Set the period — from 5 minutes to 30 days, or all time
4. Pick the format: CSV (comma-separated) or JSON
5. Tap Export

The export runs in the background: a banner shows the progress and can be minimized ("Minimize"), stopped ("Stop"), or the file opened when done ("Open").

• Pinch a chart to zoom in — down to 1/60 of the selected interval
• A zoomed chart scrolls through time
• Changing the interval resets the zoom
• Works on a merged chart of several values as well

In the numeric or regulator parameter editor, the chart settings pick the type (line, candles, area), colors and line width; they can be saved as the defaults or applied to all charts. A candle shows the first, last, lowest and highest value over 1/60 of the period.