The textual user interface to multimon-ng.
Project description
mmng-ui
A TUI (text user interface) frontend for multimon-ng.
mmng-ui will listen on a chosen UDP port for raw streams from software like SDR++, use multimon-ng to decode it,
and show you POCSAG messages in a wonderful text interface.
Table of contents
Purpose
Why not? I know there are other frontends out there, but I haevn't seen any for use in a text console.
I also wanted to learn both Rich and Textual.
Installation
The recommended way to install mmng-ui is to use pipx.
After getting pipx installed, simply run:
username@host:~$ pipx install mmng-ui
Please don't use pip system-wide.
You can of course also install it using classic virtualenvs.
How to use it
See mmng-ui --help for CLI options.
Run mmng-ui, and you'll be greeted with this screen:
Notice in the status pane, it says "Receiver: idle" -- it is now listening for UDP packets sent to the default port of 8888.
Now go to your favourite SDR application, and send to where mmng-ui is running. Make sure it is the right sample
rate that multimon-ng likes, 22050 Hz. It probably helps to send mono too.
Alpha POCSAG messages will soon display in the top pane. The bottom pane will show the raw output from multimon-ng,
as well as any errors or issues with decoding.
The status panel shows any incoming connections. Receiver will transition between the following states:
| Receiver state | Description |
|---|---|
| idle | No UDP traffic yet seen, or seen in 5 seconds |
| receiving | Actively receiving a decode from multimon-ng |
| waiting | Traffic is coming in, but nothing to be decoded |
Just below the status panel is a sparkline -- this updates on each decode, and reflects character length of said decode.
Underneath the log window in another sparkline, and this shows messages per second, for the last minute.
The footer shows available keyboard choices to quit the app, show a help screen, and clear all logging panes.
The mouse will also work!
JSON mode
mmng-ui will attempt to auto-detect the output format from multimon-ng, and if it looks like JSON, it'll use it.
JSON output isn't yet in multimon-ng, but I have a working
fork here.
Example screenshot
Here's what a screen full of decodes might look like:
Supported Python versions
mmng-ui supports Python 3.9 and newer.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mmng_ui-1.0.7.tar.gz.
File metadata
- Download URL: mmng_ui-1.0.7.tar.gz
- Upload date:
- Size: 264.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.0.1 CPython/3.13.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b73510e34b7bfb4a040d5dbae4003249ce00b1cc20c3f69247b85deb6664eaf
|
|
| MD5 |
0bfd92a136b491f7894b652858ab1701
|
|
| BLAKE2b-256 |
2e3eb67473ac2bfa1ce0238d222f7bac5c2a3b00926e3fce970a7887277d9370
|
File details
Details for the file mmng_ui-1.0.7-py3-none-any.whl.
File metadata
- Download URL: mmng_ui-1.0.7-py3-none-any.whl
- Upload date:
- Size: 23.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.0.1 CPython/3.13.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a781222c768d86d5e87d93d50945603dd34a05224bebd721d79fdccd3633a661
|
|
| MD5 |
db44f8a642b70d51257b8b5df3b27e08
|
|
| BLAKE2b-256 |
31c5fd0c516be07f79c53499b5e1a739c6723010c17d8cf3d785adb96d501457
|
