Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time

Maintainability Rating Reliability Rating Security Rating Vulnerabilities

Bugs Code Smells

qsorder - audio recordig app for N1MM and TR4W contest QSOs.

Download stable windows executable under Releases


qsorder.exe - a console app for audio recordimg of N1MM contest QSOs.


this is an external "plug-in" for N1MM which adds a QSO audio recording function. qsorder maintains a buffer in memory and listens for "Contact" UDP broadcasts sent by the logging program. The broadcasts trigger a dump of the audio buffer to a file after a specified delay time (default is 20 secs). The delay helps with capturing a tail-end after a QSO was entered into the log.

Basic usage

Download and unpack both the qsorder executable and lame.exe to the directory which will contain the contest audio (e.g. c:\contest-qsos). If prefer to save uncompressed WAV files instead of mp3's then simply delete lame.exe. ('Lame' is a very fast, free MP3 encoder)

Find the [ExternalBroadcast] section in your N1MM Logger.ini and include the lines below. This enables local QSO info UDP broadcast. For more info see N1MM UDP documentation. Restart N1MM after making changes.

(alternative instructions here: )

N1MM+: files should be extracted to ..Documents\N1MM Logger+\QsoRecording in order to play correctly from the N1MM+ log window.


Alternate broadcast configuration example (N1MM v13 and up):


In recent versions of N1MM+ it is no longer necessary to edit the .ini file directly. All configuration can be done throught the GUI:

  1. launch N1MM+
  2. on the entry window, select Config, then Configure Ports, Mode Control, Audio, Other..
  3. Click on the Broadcast Data tab.
  4. Tic the box labeled Contact.

Addtl note from Victor WB0TEV: There is also a box next to it labelled All QSOs, I'm not sure what that one does, but I notice that I checked it on the laptop I used in Belize. I'm not sure if that was necessary or superfulous. I don't seem to have that box checked on my desktop computer in my home ham shack. I guess I need to read the N1MM+ documentation to learn more. After checking that box QSOrder started working as intended.

Start qsorder.exe. If prompted by the Windows Firewall software make sure you allow local network communication. qsorder should tell you which audio input was selected. If it's not the right one, go to windows audio settings and change the "Default Recording Device" to the one you like. (note: rec input selection flag is not yet implemented) Make QSOs in N1MM.

Pressing a HOTKEY (CTRL+ALT+M or specified with --hot-key option) will save the current audio buffer to a file in AUDIO_YYYY directory. The hotkey should be recognized even when qsorder window is not in focus. Use this key whenever you hear something interesting, outside of a normal QSO (even when N1MM is not running!)

the audio files are saved to a subdirectory <contest>-<year>. Note that only a parital file name is printed to save screen space.

ReplayGain indicates the perceived loudness of the recording as reported by lame. This info is also embedded to mp3 files.

to stop qsorder either close the command window or Ctrl-Break. (the window may not react to a Ctrl-C right away - this is normal;) This is it. For any feedback please post a comment at the SF or email k3it Advanced usage

qsorder supports optional command line flags:

Advanced Usage: [options]


  -h, --help            show this help message and exit
  -D, --debug           Save debug info[default=False]
  -d DELAY, --delay=DELAY
                        Capture x seconds after QSO log entry [default=20]
  -i DEVICE_INDEX, --device-index=DEVICE_INDEX
                        Index of the recording input (use -q to list)
  -k HOT_KEY, --hot-key=HOT_KEY
                        Hotkey for manual recording Ctrl-Alt-<hot_key>
  -l BUFFER_LENGTH, --buffer-length=BUFFER_LENGTH
                        Audio buffer length in secs [default=45]
  -C, --continuous      Record continuous audio stream in addition to
                        individual QSOs[default=False]
  -P PORT, --port=PORT  UDP Port [default=12060]
  -p PATH, --path=PATH  Base directory for audio files [default=none]
  -q, --query-inputs    Query and print input devices [default=False]
  -S, --so2r            SO2R mode, downmix to mono: Left Ch - Radio1 QSOs,
                        Right Ch - Radio2 QSOs [default=False]
  -s STATION_NR, --station-nr=STATION_NR
                        Network Station Number [default=none]
  -R SAMPLE_RATE, --sample-rate SAMPLE_RATE
                        Audio sampling rate [default=11025]

Multi Multi Configuration Example N1MM Logger.ini file

  Station 0 should be  DestinationPort=12060
 	Station 1 should be  DestinationPort=12061
 	Station 2 should be  DestinationPort=12062
 	And use --port option 

	Alternatively set staion NR  using --station-nr option
  	(tnx ve2ebk)

Additional info

written in python 2.7, using threading and pyaudio libraries:

Main Thread - listens for UDP broadcasts from N1MM on port 12060

Sound card I/O thread - maintains a double ended FIFO audio buffer of the specified length (default: 45 secs)

File I/O thread(s) - dump_audio function saves the buffer to a wav file and (optionally) converts to mp3 using lame encoder. This function uses threading.timer module for scheduling

python script is repackaged into a windows executable with pyinstaller.

Tips for audio input: when possible use an isolation transformer (salvage from an old modem). For Mic In recordings use an attenuator to prevent hiss and clipping.

Hardware notes


Also in regards to QSOrder, when I first tested it out here at home (just before going to Belize) I found that I was only getting the RX audio, but not the audio of me speaking into the microphone. At home I'm using a TS-590SG and passing audio to/from my computer using the USB CODEC in the TS-590. I wanted to know if there was a way to also get the audio from the TS-590SG's front panel microphone into the USB CODEC stream so that QSOrder would pick it up as well. A post to the TS590 Yahoo group yielded the answer. Its pretty obscure but the answer is to select Menu 75 (called Mixing Beep Tones for ACC2/USB Audio Output) and set it to ON. That worked. On the earlier TS590 models (not SG) its a different Menu # (68? I think).

When in Belize, the set up in the rental shack had an IC-7300 and microHam interface into which I plug the microphone connector from my headset. One of the audio feeds I found with qsorder -q had both the RX and TX audio in it and so I used it. I can't explain how it worked, it just did. I think it was a USB CODEC stream to/from the microHam interface box.

Change history


  • add --sample-rate flag
  • switch from pyaudio to sounddevice module


  • in SO2R mode use -mr and -ml flags for mp3 encoding (N5HC)


  • include MSVC redistributable
  • rebuild with cx_freeze and make installable package (MSI)
  • Add Id tags to the MP3 files


  • hotkey function is back
  • attempt to guess recording devices charset


  • small fixes related to non-ascii character handling
  • convert code to python 3 format


  • add radio_nr flag. records qso's only from a specified Radio NR


  • minor bug fixes
  • restructured code in prep for the qtgui version
  • xml parsing exception handling


  • uninterrupted recording mode (with the -C or "--continuous" flag), parrallel to recording of individual QSOs hourly audio files are saved in the AUDIO_YEAR directory, a new mp3 file is created at the top of each hour. Extra Disk space required for this option: ~360 MB per 24 hours
  • increased sampling rate from 8000 to 11025
  • pyaduio library updated to version 0.2.8
  • allow cp1251 character set in the recording device names (tnx ua9lif)


v2.6b input selection options, debug option, skip old qsos - new flags -q, -i, -D to allow sound input selection and the debug log. - skip udp packets for old QSO, for example ignore QSO edits


  • fixes for N1MM integration issues. Play Contact now works for phone contests
  • SO2R Mode (--so2r flag). Connect Left Radio to Left audio channel, Right Radio to the Right channel.
    In this mode QSORDER will downmix the "active" audio input to MP3 mono, and mute the "inactive" radio input. In other words - Radio 1 QSOs will be recorded from the Left Ch, Radio 2 QSOs - from the Right Ch. without this flag both Left and Right channels are saved to a stereo file. HOT KEY - always saves in stereo
  • yet another change of the default global hot-key (to CTRL-ALT-O)
  • see BUGS.txt for known issues with qsorder

v2.4b change to CTRL-ALT-M as the default hot-key. Bug fix in mp3 conversion routine

v2.3b added a global hot-key (default CTRL+ALT+R).
pushing the hotkey immediately saves the current audio buffer to a file.
(qsorder window does not need to be in focus).
improvement in file/directory naming

v2.2b added UDP --port and --station-nr options for Multi-Multi setups

v2.1b added optional -l (buffer length), -d (delay), -p (path), command line flags added conversion to mp3 with (included) lame.exe encoder fix handling of / in callsigns add ReplayGain indicator to the output save audio files into a directory v2.1a

initial version (tnx n4zr,dk8nt,n2ic and others)

Future plans: Audio input selection - DONE Integration with N1MM log GUI (if N1MM team's time permits) - DONE Integration with iTunes (just kidding)

73! Vasiliy K3IT