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!

Adeel Javed - IoT Prototyping Mobile App - MQTT Viewer

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

Adeel Javed - IoT Prototyping Mobile App - MQTT Viewer Adeel Javed - IoT Prototyping Mobile App - MQTT Viewer Adeel Javed - IoT Prototyping Mobile App - MQTT Viewer

Adeel Javed - IoT Prototyping Mobile App - MQTT Viewer Adeel Javed - IoT Prototyping Mobile App - MQTT Viewer

Settings

From the toolbar on 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 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 background color of 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 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 main screen.

Server

This section contains following settings.

  • Host: Tap on the setting to edit. Enter hostname of MQTT server that you are connecting e.g. iot.eclipse.org.
  • Port: Tap on the setting to edit. Enter 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 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 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 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 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 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 on 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.

Adeel Javed - IoT Prototyping Mobile App - MQTT Viewer

Disclaimer: This mobile app has only been designed for prototyping purposes, and is not production ready.