qrzlogger/README.md

67 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

# qrzlogger
2021-05-20 18:05:33 +02: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
2022-09-05 18:06:07 +02:00
3) displays additional info on country, continent and LotW upload date of the call
4) checks if the country has not been confirmed via LotW yet and alerts the user
5) displays all previous QSOs with this call (pulled from QRZ.com logbook)
6) asks the user to enter QSO specific data (date, time, report, band etc.)
7) uploads the QSO to QRZ.com's logbook
8) fetches the just uploaded QSO from QRZ.com for review
9) starts again from 1)
2021-05-21 16:31:35 +02:00
2022-10-28 21:45:37 +02:00
# Screenshot
2021-05-21 16:31:35 +02:00
2022-07-31 11:34:54 +02:00
![screenshot](/screenshot_0.8.1.jpg?raw=true "screenshot")
2021-05-20 18:05:33 +02:00
# Installation
2021-05-20 23:17:07 +02:00
qrzlogger needs Python 3 and the following libraries:
2021-05-20 23:17:07 +02:00
2021-05-21 16:20:34 +02:00
* xmltodict
* prettytable
* colored
* requests
Furthermore, you need at least the XML subscription from QRZ.com.
2021-05-20 23:17:07 +02:00
2022-07-29 22:00:31 +02:00
Before installing qrzlogger, please make sure that the above mentioned libraries have been installed:
2021-05-20 23:17:07 +02:00
```
2022-07-29 22:00:31 +02:00
# python3 -m pip install xmltodict
# python3 -m pip install prettytable
# python3 -m pip install colored
# python3 -m pip install requests
2021-05-20 23:17:07 +02:00
```
2022-07-29 22:00:31 +02:00
To download or update qrzlogger, clone the repo:
2021-05-21 10:47:02 +02:00
```
2022-07-29 22:00:31 +02:00
# git clone https://codeberg.org/mclemens/qrzlogger.git
```
# Usage
2021-05-20 18:05:33 +02:00
2022-07-31 17:23:15 +02:00
* execute the application with "python3 qrzlogger.py" for normal mode or with "python3 qrzlogger.py -c" for contest mode
2022-09-05 17:43:12 +02:00
* qrzlogger creates a default config file and states its location (e.g. _~/.config/qrzlogger/qrzlogger.ini_)
* adapt _~/.config/qrzlogger/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)'
2022-09-05 17:43:12 +02:00
* lotw/user: Enter here your lotw user name (your call sign). Leave at "N0CALL" to disable this feature.
* lotw/password: Enter here your lotw password
* lotw/mode: Enter here the mode you would like to filter the QSL download from LotW
2022-07-29 22:01:07 +02:00
* execute the application again with "python3 qrzlogger.py"
2022-09-05 17:43:12 +02:00
* the software now tries to download the following files and stores them into the configuration directory:
* https://www.country-files.com/bigcty/download/bigcty.zip (will be extracted)
* https://lotw.arrl.org/lotw-user-activity.csv
* https://lotw.arrl.org/lotwuser/lotwreport.adi?login={}&password={}&qso_query=1&qso_qsl=yes&qso_mode={}&qso_qsldetail=yes&qso_qslsince=1970-01-01
# License
2021-05-20 18:05:33 +02:00
2022-07-31 17:23:15 +02:00
see ![LICENSE](LICENSE)