Skip to content

Commit c73df5a

Browse files
committed
README update and minor changes
1 parent 58b5fc5 commit c73df5a

File tree

4 files changed

+44
-6
lines changed

4 files changed

+44
-6
lines changed

README.md

Lines changed: 43 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,29 @@
1-
# mqtt-monitor
1+
<!-- TOC START min:1 max:6 link:true asterisk:false update:true -->
2+
- [About mqtt_monitor](#about-mqtt_monitor)
3+
- [Installation](#installation)
4+
- [With conda](#with-conda)
5+
- [With pip](#with-pip)
6+
- [Usage](#usage)
7+
- [Test server](#test-server)
8+
- [Set up your own config](#set-up-your-own-config)
9+
- [Screencast](#screencast)
10+
<!-- TOC END -->
11+
12+
13+
# About mqtt_monitor
214

315
This is a simple mqtt topic monitor written in python 3. It allows you to subscribe and listen to a number of mqtt topics and display it in a form of table. Optionally it adds some colors to the presented data.
416

5-
![](obrazki/README-d0cef477.png)
17+
![screenshot](obrazki/README-88cf8fcc.png)
18+
19+
It was tested (under GitHub Actions CI/CD) and works under:
20+
- OS: Ubuntu, MacOS, and Windows
21+
- Python versions: 3.5, 3.8, and 3.9
22+
23+
24+
[![Python application](https://github.com/filipsPL/mqtt-monitor/actions/workflows/python-app.yml/badge.svg)](https://github.com/filipsPL/mqtt-monitor/actions/workflows/python-app.yml)
25+
26+
627

728
# Installation
829

@@ -17,10 +38,26 @@ conda activate mqttmonitor
1738

1839
## With pip
1940

20-
`pip install paho-mqtt pandas tabulate`
21-
41+
`pip install -r requirements.txt`
2242

2343
# Usage
2444

25-
- create a conf file from template `cp mqtt_conf.py.sample mqtt_conf.py`
26-
- edit
45+
## Test server
46+
47+
Connect to the test server and wait for messages:
48+
49+
`./mqtt_monitor.py --conf mqtt_monitor.conf.sample`
50+
51+
## Set up your own config
52+
53+
- create a conf file from template `cp mqtt_monitor.conf.sample mqtt_monitor.conf`
54+
- edit `mqtt_monitor.conf`
55+
- run `./mqtt_monitor.py --conf mqtt_monitor.conf`
56+
- enjoy
57+
58+
59+
# Screencast
60+
61+
See the monitor in action:
62+
63+
[![asciicast](https://asciinema.org/a/mzgmn185M2SLa2caatQ8CRNrP.svg)](https://asciinema.org/a/mzgmn185M2SLa2caatQ8CRNrP)

mqtt_monitor.conf.sample

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,3 +52,4 @@ sensor2 = garden
5252
'p'= "☁ " + colors.fg.cyan
5353
'out'= colors.fg.red
5454
'in'= colors.fg.yellow
55+
'rssi'= '📶 ' + colors.fg.lightgrey

obrazki/README-88cf8fcc.png

188 KB
Loading

obrazki/README-d0cef477.png

-493 KB
Binary file not shown.

0 commit comments

Comments
 (0)