qso

Homepage: https://github.com/K6SM/Emacs-QSO-Logger

Author: David Pentrack

Updated:

Summary

Customizable, Dynamic Amateur Radio QSO Logging

Commentary

This LISP code provides some basic functions for Emacs to rapidly
capture and log amateur radio contacts (QSOs) into an ADIF file.

qso.el provides a fuction that generates a customizable, dynamic
form (qso-log-form) to log amateur radio QSOs using almost any
combination of ADIF fields in the ADIF 3.1.4 specification.
This allows the user to customize the form for use in contests or
general logging.  All customizations are accessible in the "QSO"
group, whose parent is the Emacs "Applications" group, accessed
with M-x customize.

Further processing of the logs can be done within Emacs or by
importing the ADIF file into another logging program.

Features

- Simple, customizable text interface for real-time ham radio QSO
  logging or even to rapidly convert paper log entries to an ADIF
- Runs entirely in a Linux terminal environment, allowing for its
  use in ultra-light, low-power HW/SW configurations (e.g. terminal-
  only mode on a Raspberry Pi Zero 2W)
- No mouse required (using tab or shift-tab to change fields or
  hover over buttons)
- Log entries are appended to a user-specified ADIF log file
- Any field in the ADIF 3.1.4 specification can be selected to
  appear on the form, in whatever order is desired
- Each field has an option to preserve the most recent information
  after a QSO submission
  - Example: For situations where frequency and mode unchanged
    between QSOs
  - Also useful for repeating sent information reports in contests
- Automatically populates BAND based on FREQ for commonly used
  bands, if otherwise left blank or not shown on the form
- Option to lookup callsign information and show the information
  (text) in another buffer (requires an internet connection)
- Option to check the log for duplicates before recording the QSO
- Option to clear the form without saving the information (e.g.
  for incomplete QSOs)

Getting Started

 1) Execute M-x customize, select "Applications" and then select
    "QSO" to see the customization options.
 2) Enter your callsign in the QSO Operator field.
 3) Enter the path to the ADIF file you will be using
    (e.g. ~/qsolog.adi).
 4) Add, remove, or reorder the fields you wish to have on the form.
 5) Select or deselect form fields that you wish you have cleared
    after a QSO submission (especially helpful for contests).
 6) Click "Apply" or "Apply and Save" as appropriate.
 7) Execute M-x qso-log-form to bring up and begin using the log
    entry form.

Dependencies