Home
The project has now moved to Eclipse Paho - please use the new GitHub repo at https://github.com/eclipse/paho.mqtt-spy. Don't forget to star it too! This repo will only be kept as an archive/reference.
mqtt-spy is an open source utility intended to help you with monitoring activity on MQTT topics. It's been designed to deal with high volumes of messages, as well as occasional publications.
mqtt-spy is a JavaFX application, so should work on any operating system with an appropriate version of Java 8 installed. It's been tried on various Linux distributions (Mint, Ubuntu, RedHat) and Windows 7/8.
mqtt-spy-daemon is a Java-based command line tool that does not require a GUI environment. Basic functionality works with Java 7, whereas some of the advanced features like scripting require Java 8 to be installed.
Both tools are still in development, so over the next couple of months more features should become available. For details on what's currently available see the wiki.
mqtt-spy is an open source project released under the Eclipse Public License (EPL).
Once you've had a chance to try it and wish to continue using it, please consider making a small donation to UNICEF. This is not enforced in any way and relies purely on you willing to contribute! :)
For personal use, it's totally up to you!
For commercial use, the suggested donation is £10 / €10 / $10 (per user per year).
You can make the donation directly on your local UNICEF website or via the fundraising page:
If you have any suggestions, find any bugs, or would like to contribute to the project, please get in touch, either via this page or Twitter (@mqtt_spy).
The following table shows a comparison of the key features between mqtt-spy-daemon and mqtt-spy (as seen on screenshots above).
| Feature | mqtt-spy-daemon | mqtt-spy |
|---|---|---|
| User interface | Console | GUI |
| Required version of Java | Java 7 or later | Java 8 Update 60 or later |
| Supported MQTT protocol version | 3.1 & 3.1.1 | 3.1 & 3.1.1 |
| MQTT TLS/SSL support | Yes | Yes |
| Multiple connections & connection management |
- | Yes |
| High availability (multiple server URIs, reconnection & resubscription) |
Yes | Yes |
| Configuration file driven | Yes | Yes |
| Diagnostic logging | Yes | Yes |
| Manual publications | - | Yes |
| Scripted publications | Yes (started automatically) | Yes (started via GUI) |
| Automated testing (test cases) | Yes | Yes |
| Predefined subscriptions | Yes | Yes |
| Subscription scripts (e.g. auto-reply or payload reformatting) | Yes | Yes |
| Subscription management | - | Yes |
| Received message preview | Yes (basic - in the log) | Yes (advanced - GUI & log) |
| Message browsing & searching | - | Yes |
| Message content decoding & formatting |
Yes | Yes |
| Topic summary, topic filtering & searching |
- | Yes |
| Creating message audit log | Yes | Yes |
| Message audit log browsing | - | Yes |
| Message audit log replay | Yes | Yes |
| Charts / graphing | - | Yes |
| Processing statistics | - | Yes |
| Checking for updates at start-up | - | Yes |
The project is being moved to Eclipse Paho - please use the new GitHub repo at https://github.com/eclipse/paho.mqtt-spy. Don't forget to star it too! This repo will only be kept as an archive/reference.