qrzlogger/README.md

62 lines
1.6 KiB
Markdown
Raw Normal View History

# qrzlogger
2021-05-20 12:05:33 -04:00
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)
2021-05-21 06:19:30 -04:00
4) asks the user to enter QSO specific data (date, time, report, band etc.)
2021-05-20 12:05:33 -04:00
5) uploads the QSO to QRZ.com's logbook
2021-05-24 17:02:15 -04:00
5) fetches the just uploaded QSO from QRZ.com for review
7) starts again from 1)
2021-05-21 10:31:35 -04:00
# Screnshot
![screenshot](/screenshot.jpg?raw=true "screenshot")
2021-05-20 12:05:33 -04:00
# Installation
2021-05-20 17:17:07 -04:00
qrzlogger needs Python 3 and the following libraries:
2021-05-20 17:17:07 -04:00
2021-05-21 10:20:34 -04:00
* xmltodict
* prettytable
* colored
* requests
Furthermore, you need at least the XML subscription from QRZ.com.
2021-05-20 17:17:07 -04:00
Before installing qrzlogger, please make sure that pip, setuptools and wheel are installed and up-to-date:
2021-05-20 17:17:07 -04:00
```
# python3 -m pip install --upgrade pip setuptools wheel
2021-05-20 17:17:07 -04:00
```
Finally, install qrzlogger with pip:
2021-05-21 04:47:02 -04:00
```
# python3 -m pip install qrzlogger
```
# Updating
To update qrzlogger, execute the following command:
```
# python3 -m pip install --upgrade qrzlogger
```
# Usage
2021-05-20 12:05:33 -04:00
* 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)'
2021-06-01 19:01:20 -04:00
* execute the application again with "qrzlogger"
# License
2021-05-20 12:05:33 -04:00
2021-06-01 10:21:12 -04:00
see ![LICENSE](LICENSE)