EliasOenal / multimon-ng

GNU General Public License v2.0
946 stars 210 forks source link

multimon-ng

multimon-ng is the successor of multimon. It decodes the following digital transmission modes:

Building

multimon-ng can be built using either qmake or CMake:

qmake

mkdir build
cd build
qmake ../multimon-ng.pro
make
sudo make install

CMake

mkdir build
cd build
cmake ..
make
sudo make install

The installation prefix can be set by passing a 'PREFIX' parameter to qmake. e.g: qmake multimon-ng.pro PREFIX=/usr/local

Environments

So far multimon-ng has been successfully built on:

Examples

Wav to raw

Files can be easily converted into multimon-ng's native raw format using sox. e.g:

sox -t wav pocsag_short.wav -esigned-integer -b16 -r 22050 -t raw pocsag_short.raw

GNURadio can also generate the format using the file sink in input mode short.

Pipe sox to multimon-ng

You can also "pipe" raw samples into multimon-ng using something like:

sox -t wav pocsag_short.wav -esigned-integer -b16 -r 22050 -t raw - | ./multimon-ng -

[!NOTE] Note the trailing dash, means write/read to/from stdin

Pipe rtl_fm to multimon-ng

As a last example, here is how you can use it in combination with RTL-SDR:

rtl_fm -f 403600000 -s 22050 | multimon-ng -t raw -a FMSFSK -a AFSK1200 /dev/stdin

Flac record and parse live data

A more advanced sample that combines rtl_fm, flac, and tee to split the output from rtl_rm into separate streams. One stream to be passed to flac to record the audio and another stream to for example an application that does text parsing of mulimon-ng output

rtl_fm -s 22050 -f 123.456M -g -9.9 | tee >(flac -8 --endian=little --channels=1 --bps=16 --sample-rate=22050 --sign=signed - -o ~/recordings/rtlfm.$EPOCHSECONDS.flac -f) | multimon-ng -v 0 -a FLEX -a FLEX_NEXT -t raw /dev/stdin
  1. You can pass -l to rtl_fm for the squelch level, this will cut the noise floor so less data gets encoded by flac and will significantly reduce the file size but could result in loss of signal data. This value must be tuned!
  2. Flac uses -8 here, if you run an a resource constraint device you may want to lower this value
  3. The Flac -o argument value contains $EPOCHSECONDS to make unique files when this gets restarted

To replay the recorded flac file to multimon-ng (requires sox):

flac -d --stdout ~/recordings/rtlf/rtlfm.1725033204.flac | multimon-ng -v 0 -a FLEX_NEXT -t flac -

Packaging

qmake multimon-ng.pro PREFIX=/usr/local
make
make install INSTALL_ROOT=/