Installation - foldynl/QLog GitHub Wiki

Minimum Hardware Requirements

  • Recommended display resolution: 1920 × 1080
  • CPU and memory: the same minimum requirements as the operating system
  • Graphics support for OpenGL
  • Serial/USB or network connection if radio control is used

Supported OS

  • Linux
  • Windows 10/11 (64-bit)
  • macOS (DMG builds are available)

Supported Rigs

Supported Rotators

Supported Keyers

Supported Secure Password Storage

  • Linux: LibSecretKeyring, GnomeKeyring, Kwallet4, Kwallet5
  • Windows: Windows Credential Store
  • macOS: macOS Keychain

Third-party software

  • TrustedQSL – optional, needed for LoTW uploads; included in the Flatpak package

Installation Steps - Users

Linux

Use the Ubuntu PPA or Fedora repository for native installation on those distributions. Flatpak or AppImage are the recommended alternative for other distributions.

Ubuntu — maintainer PPA

DEB packages for amd64 and arm64 are available from the QLog PPA. Check the PPA for available Ubuntu releases.

sudo add-apt-repository ppa:foldyna/qlog
sudo apt update
sudo apt install qlog

Fedora — distribution repository or GitHub Releases

sudo dnf install qlog

Alternatively, install an RPM from GitHub Releases matching the Fedora release and architecture. See the Fedora package page for repository versions.

Flatpak — Flathub

Install QLog from Flathub. With Flathub configured:

flatpak install flathub io.github.foldynl.QLog

The Flatpak package includes TrustedQSL.

AppImage and RPM packages

AppImage builds and RPM packages are available from GitHub Releases. Choose an artifact matching the distribution and architecture. To run an AppImage, make the downloaded file executable and launch it.

Other distribution packages

Distribution Installation
Debian forky sudo apt install qlog
openSUSE Tumbleweed sudo zypper install QLog

These packages are maintained by their respective distributions. Further packaging options are listed in Unofficial Repositories and on Repology.

LoTW uploads

Install TrustedQSL separately unless it is included in the selected package:

  • Ubuntu and Debian: sudo apt install trustedqsl
  • Fedora: sudo dnf install trustedqsl

Windows

Download the 64-bit installer from GitHub Releases.

Prerequisites

macOS

DMG builds are published in aa5sh/QLog Releases. Build and packaging issues for those DMGs should be reported to their maintainer.

For installation or packaging problems with distribution or community builds, contact the package maintainer.

After installation, continue with Initial Setup to configure station and device profiles.

Installation Steps - Developers

QLog uses C++11, Qt5 or Qt6, and qmake. The build instructions are maintained in Building QLog in the source repository:

  • Dependencies
  • Linux — Debian, Ubuntu and Fedora dependencies; configuration and compilation in a separate build directory
  • Windows — MSVC and Qt6, dependency paths, Qt Creator and command-line builds
  • macOS — Xcode command line tools, Homebrew and Qt Creator
  • qmake options — library paths, Hamlib version overrides and installation prefix

For container builds, AppImage and RPM packaging, and Windows installer generation, see Packaging.

macOS development builds

For local macOS builds, add QLOG_MACOS_ADHOC_SIGN=1 to the qmake arguments in Qt Creator or on the command line to enable automatic ad hoc signing. This allows macOS to authorize native alert notifications. Signing is disabled by default and requires no certificate.

Re-run qmake and rebuild after changing the option. When enabled, qlog.app is signed after each link.

To sign an existing build manually, run these commands from its build directory:

codesign --force --sign - qlog.app
codesign --verify --strict --verbose=2 qlog.app
open qlog.app