{"id":13580726,"url":"https://github.com/foldynl/QLog","last_synced_at":"2025-04-06T02:32:42.099Z","repository":{"id":37462248,"uuid":"387472117","full_name":"foldynl/QLog","owner":"foldynl","description":"Amateur radio logbook software","archived":false,"fork":true,"pushed_at":"2024-03-27T10:58:29.000Z","size":18375,"stargazers_count":90,"open_issues_count":16,"forks_count":11,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-03-27T11:57:49.972Z","etag":null,"topics":["amateur-radio","amateurradio","fldigi","hamqth","hamradio","logger","lotw","open-source","opensource","openstreetmap","qsl","qso","qt5","qt6","radioamateur","sqlite","winkey2"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"7h0ma5/QLog","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/foldynl.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-07-19T13:22:15.000Z","updated_at":"2024-05-06T18:40:10.633Z","dependencies_parsed_at":"2023-02-18T08:00:35.600Z","dependency_job_id":null,"html_url":"https://github.com/foldynl/QLog","commit_stats":null,"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foldynl%2FQLog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foldynl%2FQLog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foldynl%2FQLog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foldynl%2FQLog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/foldynl","download_url":"https://codeload.github.com/foldynl/QLog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223233230,"owners_count":17110621,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amateur-radio","amateurradio","fldigi","hamqth","hamradio","logger","lotw","open-source","opensource","openstreetmap","qsl","qso","qt5","qt6","radioamateur","sqlite","winkey2"],"created_at":"2024-08-01T15:01:54.557Z","updated_at":"2025-04-06T02:32:42.070Z","avatar_url":"https://github.com/foldynl.png","language":"C++","readme":"# QLog\n\nQLog is an Amateur Radio logging application for Linux, Windows. It\nis based on the Qt framework and uses SQLite as database backend.\n\nQLogs aims to be as simple as possible, but to provide everything the operator expects from the log to be. This log is not currently focused on contests.\n\n![Screenshot](https://foldynl.github.io/QLog/screens/qlog_main.png)\n\n## Features\n\n- Customizable GUI\n- Rig control via Hamlib, Omnirig v1 (Windows only), Omnirig v2 (Windows only), TCI\n- Rotator control via Hamlib, PSTRotator\n- HamQTH and QRZ.com callbook integration\n- DX cluster integration\n- **LoTW**, **eQSL**, **QRZ.com**, **Clublog**, **HRDLog.net**, **ON4KST Chat** integration (**eQSL includes QSL pictures download**)\n- **Secure Password Storage** for all services with password or security token\n- **Online** and **Offline** map\n- Club Member lookup\n- CW Keyer Support - CWDaemon, FLDigi (all supported modes), Morse Over CAT, WinKey v1 or v2\n- Bandmap\n- CW Console\n- WSJT-X integration\n- Station Location Profile support\n- Various station statistics\n- Basic Awards support\n- Basic Contest support\n- Custom QSO Filters\n- **NO** ads, **NO** user tracking, **NO** hidden telemetry - simply free and open-source\n- SQLite backend.\n\n### Supported OS\n* Linux\n* Windows 10 (64bit)\n* MacOS (experimental - only for developers)\n\n### Supported Rigs\n* all supported by [Hamlib](https://hamlib.github.io/)\n* all supported by [Omnirig v1](https://www.dxatlas.com/omnirig/) (Windows only)\n* all supported by [Omnirig v2](https://www.hb9ryz.ch/omnirig/) (Windows only)\n* all supported by [TCI](https://eesdr.com/en/software-en/software-en)\n\n### Supported Rotators\n* all supported by [Hamlib](https://hamlib.github.io/)\n\n### Supported Keyers\n* [CWDaemon](https://cwdaemon.sourceforge.net/)\n* [FLDigi](http://www.w1hkj.com/)\n* Morse Over CAT\n* WinKey v1 or v2 compatible hardware\n\n### Supported Secure Password Storage\n* Linux: LibSecretKeyring, GnomeKeyring, Kwallet4, Kwallet5\n* Windows: Windows Credential Store\n* MacOS: macOS Keychain\n\n### Third-party software\n* [TQSL](http://www.arrl.org/tqsl-download) – optional, needed for LoTW support\n\nFor more details, screenshots etc, please, see [QLog Wiki](https://github.com/foldynl/QLog/wiki)\n\nPlease, used [QLog Issues](https://github.com/foldynl/QLog/issues) for reporting any issue or open a [discussion](https://github.com/foldynl/QLog/discussions).\nYou can also use [QLog mailing list](https://groups.io/g/qlog)\n\n\n## Installation\n\n### Minimum Hardware Requirements\n- The recommended graphical resolution: 1920x1080\n- CPU and memory: minimum requirements the same as for your OS\n- Graphic Card with OpenGL support\n- Serial connection if radio control is used\n\n### Linux\n\nPrerequisites:\n\n- Installed Trusted QSL (Optional) - `sudo apt install trustedqsl` or from [ARRL](http://www.arrl.org/tqsl-download)\n\n**DEB packages** for currently supported Ubuntu versions are available for amd64, arm64 platforms via [Ubuntu PPA](https://launchpad.net/~foldyna/+archive/ubuntu/qlog). Ubuntu users can use following commands:\n\n`sudo add-apt-repository ppa:foldyna/qlog`\n\n`sudo apt update`\n\n`sudo apt install qlog`\n\nFedora **RPM packages** are available via GitHub [Releases](https://github.com/foldynl/QLog/releases/latest)\n\n\u003ca href='https://flathub.org/apps/io.github.foldynl.QLog'\u003e   \u003cimg width='120' alt='Download on Flathub' src='https://dl.flathub.org/assets/badges/flathub-badge-en.png'/\u003e\u003c/a\u003e\n\n**Flatpak** package is available via [Flathub](https://flathub.org/apps/io.github.foldynl.QLog). The package contains built-in TrustedQSL.\n\n### Windows\n\nPrerequisites:\n\n- Installed [Trusted QSL](http://www.arrl.org/tqsl-download) (Optional)\n- Installed [Omnirig v1](https://www.dxatlas.com/omnirig/) (Optional)\n- Installed [Omnirig v2](https://www.hb9ryz.ch/omnirig/) (Optional)\n\nInstallation package is available via GitHub [Releases](https://github.com/foldynl/QLog/releases) .\n\n### MacOS\n\nOfficial support ended. Only for developers.\n\n## Compilation\n\n### General\n\nPrerequisites\n\n- Installed Qt\n- Installed [qtkeychain-devel](https://github.com/frankosterfeld/qtkeychain) library and headers\n- Installed [OpenSSL-devel](https://wiki.openssl.org/index.php/Binaries) libraries and headers\n- Installed [HamLib-devel](https://github.com/Hamlib/Hamlib/releases/latest) libraries and headers\n\n`qmake` supports listed input parameters that affect the compilation process.\n\n- `HAMLIBINCLUDEPATH` - the path to Hamlib Includes \n- `HAMLIBLIBPATH` - the path to Hamlib Library \n- `HAMLIBVERSION_MAJOR` - Hamlib version - major number (must be present if `pkg-config` cannot determine Hamlib version)\n- `HAMLIBVERSION_MINOR` - Hamlib version - minor number (must be present if `pkg-config` cannot determine Hamlib version)\n- `HAMLIBVERSION_PATCH` - Hamlib version - patch number (must be present if `pkg-config` cannot determine Hamlib version)\n- `PTHREADINCLUDEPATH`  - the path to pthread Includes - needed for Windows Hamlib 4.5 and later. Leave empty if system libraries should be used.\n- `PTHREADLIBPATH` - the path to pthread Library - needed for Windows Hamlib 4.5 and later. Leave empty if system libraries should be used.\n- `QTKEYCHAININCLUDEPATH` - the path to QtKeyChain Includes \n- `QTKEYCHAINLIBPATH`- the path to QtKeyChain Library\n\nLeave variables empty if system libraries and Hamlib version autodetect (calling `pkg-config`) should be used during compilation (for Windows, the parameter must be present)\n\nAn example of use:\n\n`\nC:/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\" \u0026\u0026 C:/Qt/Tools/QtCreator/bin/jom/jom.exe qmake_all\n`\n\n### Windows\n\nPrerequisites\n\n- [Visual Studio 2019](https://visualstudio.microsoft.com/vs/community/)\n- QT with source codes (6.x, Qt Webengine, OpenSSL Toolkit)\n- [Omnirig v1](https://www.dxatlas.com/omnirig/)\n- [Omnirig v2](https://www.hb9ryz.ch/omnirig/)\n- [Hamlib](https://github.com/Hamlib/Hamlib/releases)\n  - hamlib-w64-4.5.5.exe is the latest\n    - Need to run the following commands to \"fix\" the library *** Fix Paths if necessary ***\n      CD \"C:\\Program Files\\hamlib-w64-4.5.5\\lib\\msvc\"\n      \"C:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\VC\\Tools\\MSVC\\14.41.34120\\bin\\Hostx64\\x64\\link.exe\" /lib /machine:X64 /def:libhamlib-4.def\n      copy libhamlib-4.lib hamlib.lib\n- Install C++ Module - https://learn.microsoft.com/en-us/vcpkg/get_started/get-started-vscode?pivots=shell-powershell\n\n\tcd C:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\VC\\vcpkg\n\tvcpkg install pthreads\n\tvcpkg install qtkeychain-qt6\n\nSystem Environmental Path Settings\n\tC:\\Program Files\\hamlib-w64-4.5.5\\bin\n\tC:\\QTTools\\vcpkg\\packages\\qtkeychain-qt6_x64-windows\\bin\n\nClone QLog Master Branch\nIn QT Creator Projects-\u003eDesktop Qt 6.8.0 MSVC2022 64Bit-\u003eBuild Steps-\u003eAdditional Arguments\n\t**** You need to update the paths accordingly ****\n\t**** Need to be on same line seperated by spaces ****\n\t\"HAMLIBINCLUDEPATH='C:\\Program Files\\hamlib-w64-4.5.5\\include'\"\n\t\"HAMLIBLIBPATH='C:\\Program Files\\hamlib-w64-4.5.5\\lib\\msvc'\"\n\t\"HAMLIBVERSION_MAJOR=4\"\n\t\"HAMLIBVERSION_MINOR=5\"\n\t\"HAMLIBVERSION_PATCH=5\"\n\t\"QTKEYCHAININCLUDEPATH=C:\\QTTools\\vcpkg\\packages\\qtkeychain-qt6_x64-windows\\include\"\n\t\"QTKEYCHAINLIBPATH=C:\\QTTools\\vcpkg\\packages\\qtkeychain-qt6_x64-windows\\lib\"\n\t\"PTHREADLIBPATH=C:\\QTTools\\vcpkg\\packages\\pthreads_x64-windows\\lib\"\n\t\"PTHREADINCLUDEPATH=C:\\QTTools\\vcpkg\\packages\\pthreads_x64-windows\\include\"\n\n\n### Linux\n\nfor Debian:\n\n`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-dev pkg-config libqt5websockets5-dev`\n\nfor Debian (QT6):\n\n`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`\n\nfor Fedora:\n\n`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`\n\nfor both:\n\n`git clone --recurse-submodules https://github.com/foldynl/QLog.git`\n\n`cd  QLog`\n\nfor Debian:\n\n`qmake QLog.pro`\n\nfor Debian (QT6):\n\n`qmake6 QLog.pro`\n\nfor Fedora:\n\n`/usr/bin/qmake-qt5`\n\nNOTE: 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.\n\nfor all:\n\n`make`\n\n### MacOS\n\nIn order to build QLog on MacOS, following prerequisites must be satisfied.\n\n1. [Xcode](#xcode) command line tools\n2. [Homebrew](https://brew.sh)\n3. [Qt](https://www.qt.io) with QtCreator\n\n##### Xcode  \n\nXcode command line tools can be installed by issuing a command in command terminal:\n\n```\nxcode-select --install\n```\n\n**N.B.:** This command doesn't install Xcode itself, however It will take some time to download and  \ninstall the tools anyway.\n\n##### MacOS build\n\nLast dependencies before building QLog are:\n\n```\n brew install qt6\n brew link qt6 --force\n brew install hamlib\n brew link hamlib --force\n brew install qtkeychain\n brew install dbus-glib\n brew install brotli\n brew install icu4c\n brew install pkg-config\n```\n\nAs soon as the steps above are finished, QLog source can be opened in QtCreator, configured, built and run.  \nQLog app (qlog.app) from the build artifacts folder can be later copied (`installed`) to `~/Applications` and  \naccessed via Spotlight search bar.\n\nNOTE: 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 is compiled from their source code repos.\n\n\n\n## License\n\nCopyright (C) 2020  Thomas Gatzweiler\n\nCopyright (C) 2021-2025  Ladislav Foldyna\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","funding_links":[],"categories":["C++"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoldynl%2FQLog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoldynl%2FQLog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoldynl%2FQLog/lists"}