Skip to content
/ MQTTX Public

A Powerful and All-in-One MQTT 5.0 client toolbox for Desktop, CLI and WebSocket.

License

Notifications You must be signed in to change notification settings

emqx/MQTTX

Repository files navigation

MQTTX Logo

GitHub Release Support Platforms Total Downloads Slack Invite Reddit Twitter Community build packages YouTube

English | 简体中文 | 日本語


MQTT X is a cross-platform MQTT 5.0 client tool open sourced by EMQ, which can run on macOS, Linux and Windows, and supports formatting MQTT payload.

MQTT X simplifies the operation logic of the page with the help of chatting software. The user can quickly create a connection to save and establish multiple connection clients at the same time. It is convenient for the user to quickly test the connection of MQTT/TCP、MQTT/TLS, MQTT/WebSocket Publish / Subscribe functions and other features.

MQTT stands for MQ Telemetry Transport. It is a publish/subscribe, extremely simple and lightweight messaging protocol, designed for constrained devices and low-bandwidth, high-latency or unreliable networks.

Preview

mqttx-preview

Installation

Currently available for download from these app stores

MacOS App Store

Get it from the Snap Store

Homebrew

The MacOS users can install MQTT X using brew cask

brew install --cask mqttx

Linux

Get it from the Snap Store

Released Packages

Download from GitHub Releases and install it.

Alternative, you can download here.

Usage

See our blog or manual for details.

  1. MQTT Broker preparation.

    • If you do not need the MQTT Broker deployed locally, you can use the online public version of EMQ X for quick test;

      Broker IP: broker.emqx.io
      Broker TCP Port: 1883
      Broker SSL Port: 8883
    • If you plan to deploy a MQTT Broker running locally, we recommend you to download EMQ X for installation. EMQ X broker is a fully open source, highly scalable, highly available distributed MQTT messaging broker for IoT, M2M and Mobile applications that can handle tens of millions of concurrent clients.

  2. Connection configuration. Click the + button in the left menu bar and fill in the corresponding required fields in the form.

  3. After the connection information is configured, click the Connect button in the upper right corner to create a connection and connect to MQTT Broker.

  4. After the MQTT is connected successfully, you can perform MQTT publish and subscription tests.

mqttx-gif

Community

The MQTT X community can be found on GitHub Discussions, where you can ask questions, voice ideas, and share your projects.

To chat with other community members you can join the EMQ X Slack.

Develop

Recommended version for Node environment:

  • v14.*.*
# Clone
git clone [email protected]:emqx/MQTTX.git

# Install dependencies
cd MQTTX
yarn install

# Compiles and hot-reloads for development
yarn run electron:serve

# Compiles and minifies for production
yarn run electron:build

After the building is successful, the corresponding installation file for the successful build ing will appear in the dist_electron directory.

If you need to package it as an installation package for an independent operating system, please refer to the following command:

# For Windows
yarn run electron:build-win

# For Linux
yarn run electron:build-linux

# For MacOS
yarn run electron:build-mac

Contributing

Please make sure to read the Contributing Guide before making a pull request.

Technology Stack

License

Apache License 2.0, see LICENSE.