67 lines
2.8 KiB
Markdown
67 lines
2.8 KiB
Markdown
# [MQTT Explorer](https://mqtt-explorer.com)
|
|
|
|
[](https://travis-ci.org/thomasnordquist/MQTT-Explorer/releases)
|
|
[](https://travis-ci.org/thomasnordquist/MQTT-Explorer/releases)
|
|
[](https://travis-ci.org/thomasnordquist/MQTT-Explorer)
|
|
[](https://ci.appveyor.com/project/thomasnordquist/mqtt-explorer/branch/master)
|
|
[](https://app.codacy.com/app/thomasnordquist/MQTT-Explorer?utm_source=github.com&utm_medium=referral&utm_content=thomasnordquist/MQTT-Explorer&utm_campaign=Badge_Grade_Dashboard)
|
|
|
|
| | | |
|
|
|:---:|:---:|:---:|
|
|
|[](https://mqtt-explorer.com/img/screen-composite.png)|[](https://mqtt-explorer.com/img/screen2.png)|[](https://mqtt-explorer.com/img/screen3.png)|
|
|
|
|
# The App has moved to [mqtt-explorer.com](https://mqtt-explorer.com)
|
|
MQTT Explorer is a comprehensive and easy-to-use MQTT Client.
|
|
Downloads can be found at the link above.
|
|
|
|
This page is dedicated to its development.
|
|
Pull-Requests and error reports are welcome.
|
|
|
|
## Run from sources
|
|
|
|
```bash
|
|
yarn
|
|
yarn build
|
|
yarn start
|
|
```
|
|
|
|
## Develop
|
|
|
|
Launch Application
|
|
```bash
|
|
yarn
|
|
yarn dev
|
|
```
|
|
|
|
The `app` directory contains all the rendering logic, the `backend` directory currently contains the models, tests, connection management, `src` contains all the electron bindings. [mqttjs](https://github.com/mqttjs/MQTT.js) is used to facilitate communication to MQTT brokers.
|
|
|
|
## Automated Tests
|
|
|
|
To achieve a reliable product automated tests run regularly on travis.
|
|
|
|
- Data model
|
|
- MQTT integration
|
|
- UI-Tests (The demo is a recorded ui test)
|
|
|
|
## Run UI-tests
|
|
A [mosquitto](https://mosquitto.org/) MQTT broker is required to run the ui-tests.
|
|
|
|
Run tests with
|
|
```bash
|
|
# Run chromedriver in a separate terminal session
|
|
./node_modules/.bin/chromedriver --url-base=wd/hub --port=9515 --verbose
|
|
```
|
|
|
|
Compile and execute tests
|
|
```bash
|
|
npm run build
|
|
node dist/src/spec/webdriverio.js
|
|
```
|
|
|
|
## License
|
|
|
|
|
|
[CC-BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0/)
|
|
|
|
The license is a little restrictive to distributing derived work, this may change in the future if the interest arises or more people work on this project.
|