MQTT dashboard for iPhone and iPad
Updated
Routix Dash is an MQTT dashboard app for iPhone and iPad. It connects to your MQTT broker, shows topics on gauges, charts and switches you design yourself, and publishes messages when you tap. It is free to start, needs no account, and is the successor to the MQTT Dash app.
This guide shows what you can build and the shortest way to your first MQTT data piece.
What you can do with MQTT
- Any broker. Mosquitto, EMQX, HiveMQ, a broker built into your home automation hub, or a cloud broker. MQTT 3.1.1 and MQTT 5, with or without TLS, with a user name and password when the broker asks for them.
- Subscribe with wildcards. One data source can follow several topic filters, including
+and#. - Pick fields from JSON. A message such as
{"temperature": 21.4, "humidity": 48}can feed two components: one showsvalue?.temperature, the othervalue?.humidity. - Show it your way. More than 40 components: labels, dial gauges with warning and alarm zones, charts, toggles, sliders, color pickers, alarm banners and more.
- Publish on tap. A toggle, button or slider sends a message to a topic.
- Several brokers at once. Each MQTT connection is shared by any number of data sources and data pieces. HTTP, WebSocket and SSE sources can sit on the same dashboard.
Build your first MQTT data piece
You need the address of your broker. To try the app without one, follow Get started: MQTT, which uses a free public broker.
1. Add the broker
Open the menu → MQTT connections → Add MQTT connection. Enter a Name, the Host and the Port (usually 1883, or 8883 with Use TLS on). Fill in the user name and password if your broker needs them.
Tap Test. When you see Connected successfully., tap the save tick.
2. Subscribe to a topic
Open the menu → Data sources → Add data source. Set Data source type to MQTT, choose your MQTT connection, and enter the topic under Topic filters (subscribe), for example home/livingroom/climate.
Save. Each new message on that topic now updates the data source.
3. Show the value
On a data section, tap Add data piece manually and pick Design your own data piece. Set your MQTT source as the root data source, then tap Add component and choose Label or Dial gauge.
If the message is JSON, show one field of it: select the component, turn Inherited off, and under Data transformers pipe tap Add... → Simple expression. Enter value?.temperature.
4. Publish with a tap
Add a Toggle to the data piece and set On value and Off value to the text your device expects, for example ON and OFF.
Under Events → On tap, a new Toggle already has Apply value. It flips 1 and 0, so tap it and change Value to {{ value == "ON" ? "OFF" : "ON" }}: the toggle then flips between ON and OFF.
Then tap Add... below it and choose MQTT send. Pick the connection and enter the topic to publish to, for example home/livingroom/lamp/set. Leave Payload empty to send the toggle's new value, or type your own text.
Guides for popular devices
Tips
- Nothing shows until the next message. A broker only delivers the last message right away when it was published with retain. Publish your device's state with retain on, or wait for the next report.
- Topics are case-sensitive.
Home/Lampandhome/lampare different topics. - Away from home. A broker on your home network is reachable only on that network. To use the dashboard elsewhere, connect through a VPN to your home or use a broker that is reachable from the internet, with TLS and a password.
- Check the connection log. Open MQTT connections, choose the connection and read the log when a status dot shows disconnected.
Read more
- Get started: MQTT — the full tutorial, step by step
- Data sources (incoming) — every MQTT subscribe option
- Components — the full list of components
- Tap actions — everything a tap can do
- Home Assistant dashboard — live sensors, lights and plugs from Home Assistant