/ToppLog

Basic BASH Amateur Radio Logger

Primary LanguageShellGNU General Public License v2.0GPL-2.0

ToppLog - Not Another Logger?

With the plethora of amateur radio logging solutions out there, why would you want to use this one?

The simple answer is, you likely wouldn't. I created this for my own use, so I could log while out /P using an old Linux laptop booted into tty mode. I didn't want a flashy UI, I didn't want lots of different features. I simply wanted to be able to reliably log the contacts I made.

This logger can work either with CAT control or without. It can also be set up for basic serial exchange contests. The confirm process at the end of each QSO is a little clunky, but I wanted to be sure the user wasn't logging garbage, and as there is no way to view the log file 'live' (without opening it in a new window each time), it is important the user confirm the contact before logging it.

Features

  • Logs based on UTC time by default
  • Exports log into .csv format for easy conversion to ADIF etc
  • Includes support for HamLib's rigctl CAT control software (separate installation needed)
  • Requires very little in the way of processing power
  • Runs within the command line/terminal/BASH
  • Can be used to log simple incremental number contests (more features to be added anon)
  • Confirms each QSO before logging and allows you to correct any errors
  • Allows user to carry manually entered frequency and mode information over multiple QSOs to save entering the same information each time

CAT Control

To make use of the CAT control features, you need to install and run Hamlib's rigctld (rig control daemon) software. This is a fairly simple procedure and, included in the repository, is the file 'xiegu.sh' which I use to start the daemon when I am out /P. This daemon should be left running in the background and, if you wish, ToppLog will connect to it and take frequency and mode information from the radio. For more information, see man rigctld and the Hamlib GitHub repo.

CSV to ADIF

There are many ways to convert between CSV and ADIF, but I recommend this one - csv2adif - written by Tom M0 LTE, which he wrote to work with ToppLog's CSV output.

Contesting

As mentioned above, this logging software includes basic support for contests - namely a serial counter (1,2,3 etc) and a space to log the other station's serial. In time I may add other features, but bear in mind this is a simple logger and not designed to deal with complex contests. There are plenty of better contest loggers out there!

Feedback

If you have any feedback about ToppLog, or want to see new features added (within reason!), please contact me. Either using GitHub, or via gm5aug@topple.scot.

Happy logging!

73 Michael GM5 AUG

gm5aug.topple.scot