Tyler Carr

Oct 02, 2021


What is PylogCQ, and why?

PylogCQ is a curses based TUI logging program for Amateur Radio use.


I started writing PylogCQ because I wanted a dead simple logging program that I could use from the command line, and remotely. PylogCQ uses the npyscreen library to build it's UI and Hamlib for CAT control.


PylogCQ is meant to be simple.

PylogCQ exposes the cq endpoint when installed.

If no rig control arguments are passed to cq the TUI offers basic contact (QSO) information fields to the user for input. Frequency and Mode input is retained between QSOs, PylogCQ assumes you haven't changed these things unless you tell it you have. PylogCQ will also assume a perfect 599 signal report both ways if nothing is input. QSO time/date are recorded at the time of logging. These all combine to result in extremely fast logging of QSOs, leaving the user free to work the radio and make contacts.

If a hamlib rigctld server is specified, as: cq -r -p 4534 PylogCQ reads the frequency and mode from a connected radio.

PylogCQ writes each QSO to a running swap (recovery) file in JSON format, and converts that file to an ADIF on clean exit.


PylogCQ is available on the Python Package Index (PyPI)


python3 -m pip install pylogcq