MQTT Viewer is a simple, configurable & ready to use internet of things (IoT) client. This app has been designed to help you get started with your IoT journey. Simply configure your MQTT server details, and start receiving events in the app immediately. Great for prototyping!
Features
- Simple & clean user interface
- Connects to different MQTT servers
- Supports username and password authentication
- Accepts both plain and JSON format messages
- Creates notifications when new messages arrive
- Allows to customize color theme
- Allows to choose any icon from Font Awesome and Weather Icons libraries
- Provides line chart and bar chart for data visualization
Settings
From the toolbar on the top right, select Settings.
General
This section contains following settings.
- App Name: Tap on the setting to edit. Enter app name that will be shown on top of the main screen and as the title for any notifications.
- Background Color: Tap on the setting to edit. Enter a color in hex format i.e. #FFFFFF. This setting will change the background color of the main screen.
- Foreground Color: Tap on the setting to edit. Enter a color in hex format i.e. #FFFFFF. This setting will change text color on the main screen.
- Highlighter Color: Tap on the setting to edit. Enter a color in hex format i.e. #FFFFFF. This setting will change the color for charts displayed on the main screen.
Server
This section contains following settings.
- Host: Tap on the setting to edit. Enter the hostname of MQTT server that you are connecting e.g. iot.eclipse.org.
- Port: Tap on the setting to edit. Enter the port number of MQTT server that you are connecting e.g. 1883.
- Username: Tap on the setting to edit. If MQTT server requires authentication, then enter provided username.
- Password: Tap on the setting to edit. If MQTT server requires authentication, then enter provided password.
- Topic: Tap on the setting to edit. Enter the topic name that the app will subscribe.
- Device: Tap on the setting to edit. Enter a device name, in some cases, MQTT servers require device name to be in a specific format, otherwise, this information shows up in MQTT logs when a client connects.
- QoS: Tap on the setting to edit. Select 0 or 1 for the quality of service.
Message
This section contains following settings.
- Enable JSON Format: App supports both plain and JSON formats. Tap on the setting to enable/disable.
- Data Key: Tap on the setting to edit. If JSON Format is enabled, then enter key of the field in JSON that contains sensor data e.g. {key: temperature value: 25}, enter the value in this field, and the app will automatically extract that information.
Notifications
This section contains following settings.
- Enable: App generates notifications when a new message arrives from MQTT server both plain and JSON formats. Tap on the setting to enable/disable.
Widgets
This section contains following settings.
- Show Icon: Tap on the setting to enable/disable if an icon should be shown on the main screen.
- Icon Library: If enabled, tap on the setting to edit. App currently supports Font Awesome and Weather Icons libraries. Select an icon library.
- Icon Type: If enabled, tap on the setting to edit. Enter font code available from respective library site (links provided below). Only enter the 4 digit code e.g. f00d, do not enter &#x before and ; after the code.
- Show Chart: Tap on the setting to enable/disable if a chart should be shown o the main screen.
- Chart Type: If enabled, tap on the setting to edit. Select chart type, currently only Line chart and Bar chart available. Only numeric messages are displayed on the chart, non-numeric messages are skipped from historical chart.
Disclaimer: This mobile app has only been designed for prototyping purposes, and is not production ready.