# README

mqttcli -- MQTT Client for shell scripting

mqttcli is an MQTT 3.1.1 Client which has almost same options with mosquitto_pub/sub. However, it has additional functionality and a pubsub command which is suite for the shell script pipelining.

Install

Download from here_. Please choose your artitecture. (and chmod ugo+x if needed)

.. _here: https://github.com/shirou/mqttcli/releases/latest

::

curl https://raw.githubusercontent.com/shirou/mqttcli/master/install.sh | sh

Or if you have golang environment, type this to build on your host.

::

go get github.com/shirou/mqttcli

Usage

common

You can set host, port, username and password on the Environment variables.

::

export MQTT_HOST="localhost"
export MQTT_PORT="1883"
export MQTT_USERNAME="user"
export MQTT_PASSWORD="blahblah"

or using a config file. You can specify a config file by --conf option. or automatically load from ~/.mqttcli.cfg.

::

% mqttcli sub --conf yoursettings.json -t "some/topic"

example:

::

{ "host": "localhost", "port": 1883, "username": "user", "password": "blahblah" }

If you use AWS IoT, you can use these JSON as mqttcli config file, such as

::

{ "host": "A3HVHEAALED.iot.ap-northeast-1.amazonaws.com", "port": 8883, "clientId": "something", "thingName": "something", "caCert": "path/to/root-CA.crt", "clientCert": "path/to/2a338xx2xxf-certificate.pem.crt", "privateKey": "path/to/aad380efffx-private.pem.key" }

You may change cert files path to where you placed.