qrzlogger/README.md

65 lines
2.4 KiB
Markdown
Raw Normal View History

# qrzlogger
2021-05-20 16:05:33 +00: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 10:19:30 +00:00
4) asks the user to enter QSO specific data (date, time, report, band etc.)
2021-05-20 16:05:33 +00:00
5) uploads the QSO to QRZ.com's logbook
2021-05-24 21:02:15 +00:00
5) fetches the just uploaded QSO from QRZ.com for review
7) starts again from 1)
2021-05-21 14:31:35 +00:00
# Screnshot
2022-07-31 09:34:54 +00:00
![screenshot](/screenshot_0.8.1.jpg?raw=true "screenshot")
2021-05-20 16:05:33 +00:00
# Installation
2021-05-20 21:17:07 +00:00
qrzlogger needs Python 3 and the following libraries:
2021-05-20 21:17:07 +00:00
2021-05-21 14:20:34 +00:00
* xmltodict
* prettytable
* colored
* requests
Furthermore, you need at least the XML subscription from QRZ.com.
2021-05-20 21:17:07 +00:00
2022-07-29 20:00:31 +00:00
Before installing qrzlogger, please make sure that the above mentioned libraries have been installed:
2021-05-20 21:17:07 +00:00
```
2022-07-29 20:00:31 +00:00
# python3 -m pip install xmltodict
# python3 -m pip install prettytable
# python3 -m pip install colored
# python3 -m pip install requests
2021-05-20 21:17:07 +00:00
```
2022-07-29 20:00:31 +00:00
To download or update qrzlogger, clone the repo:
2021-05-21 08:47:02 +00:00
```
2022-07-29 20:00:31 +00:00
# git clone https://codeberg.org/mclemens/qrzlogger.git
```
# Usage
2021-05-20 16:05:33 +00:00
2022-07-31 15:23:15 +00:00
* execute the application with "python3 qrzlogger.py" for normal mode or with "python3 qrzlogger.py -c" for contest mode
2022-09-05 15:43:12 +00: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 15:43:12 +00: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 20:01:07 +00:00
* execute the application again with "python3 qrzlogger.py"
2022-09-05 15:43:12 +00: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 16:05:33 +00:00
2022-07-31 15:23:15 +00:00
see ![LICENSE](LICENSE)