Skip to content

Activate License ​

HAM-Tools uses an offline license system (Ed25519-signed). No server check, no online requirement after activation.

Free while in beta

As long as HAM-Tools is in beta, the license is free of charge — just request it by email (see below). The model further down describes how the license and the update window work technically.

Request a License ​

A short email to hb9hji@funkwelt.net with:

  • Name
  • Callsign (1–3 possible, if you have several)
  • Optional: how you heard about HAM-Tools

In the app you can also use Settings → License → Request license → “Open mail”. If no mail app is set up, the request text is shown below, ready to copy.

You'll get a ~300-character license string in reply, in this format:

ham1.eyJjYWxscy...Q.SGVsbG8...4

Apply the License ​

  1. Cmd+, → License tab
  2. Paste the license string into the text field (Cmd+V or the "Paste from Clipboard" button)
  3. Click "Apply license"
  4. The status should jump straight to "Full version active" (green)

Line breaks inserted into the string by a mail app are removed when pasting. If the string is invalid, the app reports “Not accepted: … — your existing license is kept.” and saves nothing

from 1.55.

Model: Lifetime with 12 Months of Updates ​

  • One-time purchase — the license technically never expires
  • Updates included for 12 months from the issue date
  • Old app versions stay fully functional for life with the original license
  • For versions beyond the update window: request a renewal (cheaper than a new purchase)

TIP

On startup the app checks whether the build date of the current app version is before the updates_until date of your license. If so → full mode. If not → demo mode with a note about renewing updates.

Demo Mode ​

Without a valid license:

  • 50 newly logged QSOs cumulative across all logs combined (the counter spans all logs and is not reset by deleting)
  • After that no new logging: existing QSOs remain readable, editable and exportable (ADIF, Cabrillo). A QSO above the limit is not dropped silently: the logbook shows “Demo limit reached”, and QSOs from WSJT-X & Co. trigger a system notification
  • ADIF import remains unlimited — existing logs can be brought over completely even in demo mode
  • A banner at the top of the app shows the current status at any time

Multiple Macs ​

You can use one license on multiple Macs as long as they all use the same callsign. The license model checks the callsign in the app settings against the 1–3 callsigns stored in the license.

Problems? ​

ErrorMeaning
"Invalid signature"The license was truncated when copied, or is from a different build key pair
"Call doesn't match license"The callsign entered under Settings → Station is not stored in the license — or no callsign is entered yet (then the app runs in demo mode despite a license)
"Update renewal required"The app version was built after the updates_until date — either install an older app version or request a renewal

Report a bug → or email hb9hji@funkwelt.net.

Third-party components from 1.41 ​

HAM-Tools itself is proprietary, but it ships six standalone helper programs. They run as separate processes — HAM-Tools calls them via the command line, files or the network and does not link their code into the app.

ComponentWhat forLicence
ardopcf (fork of pflarue/ardop 1.0.4.1.3)ARDOP modem for Winlink over radioMIT
rigctld and rotctld from Hamlib 4.7.1CAT control and rotatorGPL-2.0-or-later (programs), LGPL-2.1-or-later (library)
nec2c 1.3 by Neoklis Kyriazis 5B4AZCompute core of the antenna simulatorsee below
wsprd from WSJT-X (K9AN, K1JT, KA9Q), with FFTW 3.3.10WSPR decoderGPLv3
rade_helper via the rade_c library (FreeDV project) and OpusRADE decoder for FreeDVBSD-2-Clause (rade_c, rade_helper), BSD-3-Clause (Opus)

In addition, one library is compiled into the app: ft8_lib by Kārlis Goba (MIT) for the FT8/FT4 module — message packing, LDPC and the decoder. Our revision carries a small patch (RR73 encoded as WSJT-X does); commit, checksums and the patch are recorded in ft8_lib-SOURCES.txt in the app's licence folder.

Also compiled in, all under MIT or BSD licenses:

ComponentPurposeLicense
kiss_fft by Mark Borgerding (part of ft8_lib)FFT in the FT8/FT4 decoderBSD-3-Clause
wl2k-go (LA5NTA) and Pat-Vara (Jeremy Bush), ported to SwiftWinlink protocol (B2F)MIT
Country file (cty) by Jim Reisert AD1CDXCC lookup for callsignsMIT
hamradio-zones-geojson by HB9HILCQ and ITU zone boundaries on the mapsMIT

The overview and the full licence texts are in the app under Settings → License → Third-party components; the texts live inside the app bundle, so they are available offline.

Online data sources from 1.61 ​

Some modules display data from external services without containing their code. The Forecasts window uses the ionospheric map from prop.kc2g.com (Andrew Rodland KC2G, funded by WWROF, source code on GitHub), which is based on the measurements of the ionosondes provided by GIRO (Global Ionospheric Radio Observatory, UMass Lowell), INGV, NOAA and BoM. GIRO's "Rules of the Road" ask that the station operators be acknowledged — we do so here and in the window. HAM-Tools does not query these services directly but through a mirror on toolbox.funkwelt.net that loads the source once every quarter of an hour.

The Beacons module shows the locations, locators and operating status of the beacons of the NCDXF/IARU International Beacon Project (ncdxf.org/beacon). This information is built into the app with its date; the module does not query the NCDXF.

nec2c: two licence statements in the same package

The author writes in README section 7: “nec2c is Public Domain, same as the original FORTRAN source” — with a request to keep derived software open. The package also contains a COPYING with the GPLv3, while the source files carry no GPL headers. Both files are shipped unchanged. The underlying NEC2 FORTRAN code comes from Lawrence Livermore National Laboratory and is in the public domain as US government work.

ardopcf, rigctld/rotctld and nec2c are unmodified builds of the public sources. rade_helper is a small program of our own that statically links the unmodified rade_c library and an Opus build with the patches from the rade_c repository. The wsprd build replaces the optional OSD deep decoding (Fortran, off by default) with a stub. The build scripts in the project document version, tag, checksum, configure flags and the stub source.

Source code of the GPL programs from 1.62 ​

For every version, a source package sits next to the DMG. It holds the complete source code of wsprd (with FFTW and the OSD stub), rigctld/rotctld (Hamlib) and nec2c, exactly as shipped, together with the build scripts:

https://toolbox.funkwelt.net/app/source/HAM-Tools-‹version›-gpl-sources.tar.gz

‹version› is your app's version number, e.g. 1.62.0. Older packages stay available for at least three years. Questions to hb9hji@funkwelt.net.

HAM-Tools © HB9HJI · Funkwelt