This LISP code provides some basic functions for Emacs to rapidly capture and log amateur radio contacts (QSOs).
qsologger.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-logger 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.
- 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)
- Place qsologger.el in the load path. If one hasn't been established, you can place it in
~/.emacs.d/lisp/
and then, in the init.el file (located in ~/.emacs.d/) add:(add-to-list 'load-path "~/.emacs.d/lisp/")
- Add to the init.el file:
(require 'qsologger)
- Restart Emacs
- Execute
M-x customize
, select "Applications" and then select "QSO Logger" to see the customization options. - Enter your callsign in the Operator field.
- Enter the path to the ADIF file you will be using (e.g.
~/qsolog.adi
). - Add, remove, or reorder the fields you wish to have on the form.
- Select or deselect form fields that you wish you have cleared after a QSO submission (especially helpful for contests).
- Click "Apply" or "Apply and Save" as appropriate.
- Execute
M-x qso-log-form
to bring up and begin using the log entry form.