A python application to log QSOs directly to QRZ.com from the command line
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Michael Clemens b517e87bc6 user can now retry if upload failed 6 months ago
src/qrzlogger user can now retry if upload failed 6 months ago
LICENSE moved license to extra file 8 months ago
README.md fixed README 6 months ago
pyproject.toml qrzlogger now uses setuptools for packaging and installation 8 months ago
screenshot.jpg added screenshot 8 months ago
setup.cfg v0.6.9 -> v0.7.0 7 months ago



This script is a QRZ.com command line QSO logger. It does the following:

  1. asks the user for a call sign
  2. displays available call sign info pulled from QRZ.com
  3. displays all previous QSOs with this call (pulled from QRZ.com logbook)
  4. asks the user to enter QSO specific data (date, time, report, band etc.)
  5. uploads the QSO to QRZ.com's logbook
  6. fetches the just uploaded QSO from QRZ.com for review
  7. starts again from 1)




qrzlogger needs Python 3 and the following libraries:

  • xmltodict
  • prettytable
  • colored
  • requests

Furthermore, you need at least the XML subscription from QRZ.com.

Before installing qrzlogger, please make sure that pip, setuptools and wheel are installed and up-to-date:

# python3 -m pip install --upgrade pip setuptools wheel

Finally, install qrzlogger with pip:

# python3 -m pip install qrzlogger


To update qrzlogger, execute the following command:

# python3 -m pip install --upgrade qrzlogger


  • execute the application with "qrzlogger"
  • qrzlogger creates a default config file and states its location (e.g. ~/.qrzlogger.ini)
  • adapt ~/.qrzlogger.ini to your needs. Important setting are:
    • station_call: This is your station call (must match with the QRZ.com logbook)
    • api_key: Your QRZ.com API key. You find it under "settings" in the QRZ.com logbook'
    • qrz_user: Your QRZ.com user name, typically your call sign'
    • qrz_pass: Your QRZ.com password (not the API key)'
  • execute the application again with "qrzlogger"