Skip to content

Repository files navigation

QuickLogger icon

QuickLogger

Latest release License: GPL v3 Build

A free, keystroke-driven net logger for ham radio and GMRS that knows your stations.

Type a few letters of a callsign and QuickLogger offers the stations your net already knows first, then licensed stations near you, nearest first. Pick one and the name, city, county and grid square fill in on their own. Run it on your own computer, or on one always-on server that your whole group logs into over SSH.

Autocomplete while logging a check-in: stations the net knows first, then licensed stations nearby with their distance

A net's History: its sessions above, the check-ins of the selected one below

Why QuickLogger

  • It remembers your regulars. Every station that checks in is saved to its net. Saved stations come first in autocomplete and carry default remarks ("mobile", "EOC") that fill in at check-in.
  • It finds stations by distance. Autocomplete adds licensed stations near the net's ZIP or postal code, nearest first with the miles shown, from FCC data (US amateur and GMRS) and ISED data (Canadian amateur). You set the radius.
  • Station details fill themselves in. Name, address, county and grid square come from the license data and the ZIP code, so a check-in is often just the callsign.
  • Everything is a keystroke. Every action is on a labeled F-key. No mouse, and nothing to hunt for while the net is running.
  • One shared server, no accounts to manage. Operators ssh straight into the app with their own keys. There are no operating-system accounts to create, and a user can be view-only for observers. Mosh works too, for laptops and phones on bad connections.
  • Your data goes where you need it. Export a session as a log, as ADIF for your logging program, or as a QuickLogger file for another install. Installs can also push closed sessions to a central server and pull nets back.
  • Free, and GMRS is a first-class citizen. No cost, and the source is open (GPL v3 only).

Quick start

  1. Download the file for your system from the latest release.
  2. Install the libraries it uses and unpack it (below).
  3. Run ./QuickLogger (QuickLogger.exe on Windows) from the folder you want its data kept in. It asks for your call sign and ZIP, then downloads the license data on first launch.
macOS (Apple Silicon, macOS 13+)
brew install libssh
tar xzf QuickLogger-<version>-macos-arm64.tar.gz
xattr -d com.apple.quarantine QuickLogger-<version>-macos-arm64/QuickLogger

The xattr line is only needed if a web browser downloaded it: the binary isn't signed by an Apple-registered developer.

Linux (amd64, arm64)
sudo apt install libssh-4 libcurl4t64 libsqlite3-0
tar xzf QuickLogger-<version>-linux-amd64.tar.gz

That's for Debian 13 and Ubuntu 24.04 and newer. For Debian 12, Ubuntu 22.04 and Fedora, see Installing QuickLogger.

FreeBSD 15 (amd64, arm64)
sudo pkg install libssh curl sqlite3
tar xzf QuickLogger-<version>-freebsd-amd64.tar.gz
Windows (x64, arm64)

Unzip it and run QuickLogger.exe from Windows Terminal. Nothing else to install. It isn't signed, so SmartScreen may stop it the first time: choose More info, then Run anyway.

The Windows build is console only, with no SSH server. To host a shared net, run it on macOS, Linux or FreeBSD, or in WSL2.

Other systems can build it from source. Every download has a .sha256 file to check it against.

What do you want to do?

Supported platforms

Platform Support Verified
macOS (Apple Silicon) Full Built and run natively
Linux (glibc and musl) Full Built and fully tested on every change on Ubuntu, Debian, Fedora and Alpine
FreeBSD 14 / 15 Full Built and fully tested on FreeBSD 15 for every release
Windows Console only: no SSH server, no ZMODEM Built and fully tested for every release

Release binaries for every platform have also been run on real systems. The details are in Installing QuickLogger.

Documentation

License and help

QuickLogger is free software under version 3 of the GNU General Public License only, not any later version (SPDX: GPL-3.0-only).

Found a bug, or want something added? Open an issue.

Moved sections

Links to these old README sections land here.

Running QuickLogger

Moved to Installing QuickLogger.

Building QuickLogger

Moved to Building QuickLogger.

Built-in SSH server

Moved to the Shared server guide and Connecting.

About

Free terminal net logger for ham radio and GMRS: saved stations, nearby-station matching by distance, and shared nets over SSH

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages