Installation - foldynl/QLog GitHub Wiki

Minimum Hardware Requirements

  • The recommended graphical resolution: 1920x1080
  • CPU and memory: minimum requirements the same as for your OS
  • Graphic Card with OpenGL support
  • Serial/USB or network connection if radio control is used

Supported OS

  • Windows 10 (64bit)
  • Linux
  • MacOS

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

  • TQSL – optional, needed for LoTW support

Installation Steps - Users

Linux

Prerequisites

  • Installed Trusted QSL (Optional) - apt install trustedqsl

DEB packages for currently supported Ubuntu versions are available for amd64 and arm64 platforms via Ubuntu PPA. Ubuntu users can use following commands:

sudo add-apt-repository ppa:foldyna/qlog

sudo apt update

sudo apt install qlog

RPM packages are available via GitHub Releases

Flatpak package is available via Flathub. The package contains built-in TrustedQSL.

Snap is not planned at this moment.

Windows

Prerequisites

WIN64 Installation .exe packages are available via GitHub Releases.

MacOS

Prerequisites

  • Installed TQSL (Optional)

DMG package is available via GitHub Releases

Installation Steps - Developers

Prerequisites

qmake supports listed input parameters that affect the compilation process.

  • HAMLIBINCLUDEPATH - the path to Hamlib Includes
  • HAMLIBLIBPATH - the path to Hamlib Library
  • HAMLIBVERSION_MAJOR - Hamlib version - major number (must be present if pkg-config cannot determine Hamlib version)
  • HAMLIBVERSION_MINOR - Hamlib version - minor number (must be present if pkg-config cannot determine Hamlib version)
  • HAMLIBVERSION_PATCH - Hamlib version - patch number (must be present if pkg-config cannot determine Hamlib version)
  • PTHREADINCLUDEPATH - the path to pthread Includes - needed for Windows Hamlib 4.5 and later. Leave empty if system libraries should be used.
  • PTHREADLIBPATH - the path to pthread Library - needed for Windows Hamlib 4.5 and later. Leave empty if system libraries should be used.
  • QTKEYCHAININCLUDEPATH - the path to QtKeyChain Includes
  • QTKEYCHAINLIBPATH- the path to QtKeyChain Library

Leave variables empty if system libraries and Hamlib version autodetect (calling pkg-config) should be used during compilation (for Windows, the parameter must be present)

An example of use:

C:/Qt/6.4.1/msvc2019_64/bin/qmake.exe C:\Users\devel\development\QLog\QLog.pro -spec win32-msvc "CONFIG+=qtquickcompiler" "HAMLIBINCLUDEPATH = C:\Users\devel\development\hamlib\include" "HAMLIBLIBPATH = C:\Users\devel\development\hamlib\lib\gcc" "HAMLIBVERSION_MAJOR = 4" "HAMLIBVERSION_MINOR = 5" "HAMLIBVERSION_PATCH = 0" "QTKEYCHAININCLUDEPATH = C:\Users\devel\development\qtkeychain_build\include" "QTKEYCHAINLIBPATH = C:\Users\devel\development\qtkeychain_build\lib" && C:/Qt/Tools/QtCreator/bin/jom/jom.exe qmake_all

Linux

for Debian:

sudo apt-get -y install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools libsqlite3-dev libhamlib++-dev libqt5charts5-dev qttools5-dev-tools libqt5keychain1 qt5keychain-dev qtwebengine5-dev build-essential libqt5serialport5-devpkg-config libqt5websockets5-dev

for Debian (QT6):

sudo apt-get -y install libhamlib-dev build-essential pkg-config qt6-base-dev qtkeychain-qt6-dev qt6-webengine-dev libqt6charts6-dev libqt6serialport6-dev libqt6webenginecore6-bin libqt6svg6-dev libgl-dev libqt6websockets6-dev

for Fedora:

dnf install qt5-qtbase-devel qt5-qtwebengine-devel qt5-qtcharts-devel hamlib-devel qtkeychain-qt5-devel qt5-qtserialport-devel pkg-config qt5-qtwebsockets-devel libsqlite3x-devel

for all:

git clone --recurse-submodules https://github.com/foldynl/QLog.git

cd QLog

for Debian:

qmake QLog.pro

for Debian (QT6):

qmake6 QLog.pro

for Fedora:

/usr/bin/qmake-qt5

NOTE: if it is necessary then use qmake input parameters described above to affect compilation. The input parameter must be use in case when Hamlib or qtkeychain are compiled from their source code repos.

for all:

make

Windows

Prerequisites

  • Visual Studio 2019
  • QT with source codes
  • Omnirig v1 and v2
  • qtkeychain package (via vcpkg)

To be honest, It is not easy to compile it under Windows but it is possible.

MacOS

In order to build QLog on MacOS, following prerequisites must be satisfied.

  1. Xcode command line tools
  2. Homebrew
  3. Qt with QtCreator
Xcode

Xcode command line tools can be installed by issuing a command in command terminal:

xcode-select --install

N.B.: This command doesn't install Xcode itself, however It will take some time to download and install the tools anyway.

MacOS build

Dependencies before building QLog are:

 brew install qt6
 brew link qt6 --force
 brew install hamlib
 brew link hamlib --force
 brew install qtkeychain
 brew install dbus-glib
 brew install brotli
 brew install icu4c
 brew install pkg-config

As soon as the steps above are finished, QLog source can be opened in QtCreator, configured, built and run. QLog app (qlog.app) from the build artifacts folder can be later copied (installed) to ~/Applications and accessed via Spotlight search bar.

NOTE: if it is necessary then use qmake input parameters described above to affect compilation. The input parameter must be use in case when Hamlib or qtkeychain are compiled from their source code repos.