mirror of
https://codeberg.org/mclemens/colorspot.git
synced 2024-11-15 20:16:06 -05:00
a colorized cli DX cluster client
colorspot.py | ||
LICENSE.md | ||
README.md | ||
screenshot.png |
ColorSpot
This script is a command line DX cluster client. It adds the following benefits to the default telnet stream:
- displays the DX station's country
- displays the DX station's continent
- displays if the DX station uses LotW
- downloads your LotW QSL file and marks all lines with countries that need to be confirmed
- displays lines in different colors depending on the continent or band (user configurable)
Screnshot
Installation
ColorSpot needs Python 3 and the following libraries:
- colored
- requests
- Telnet
- zipfile
Furthermore, you need an account at LotW for some of teh features.
Before installing ColorSpot, please make sure that pip, setuptools and wheel are installed and up-to-date:
# python3 -m pip install --upgrade pip setuptools wheel
Finally, install ColorSpot with pip:
# python3 -m pip install colorspot
Updating
To update colorspot, execute the following command:
# python3 -m pip install --upgrade colorspot
Usage
- execute the application with "colorspot"
- colorspot creates a default config file and states its location (e.g. ~/.colorspot.ini)
- adapt ~/.colorspot.ini to your needs. Important setting are:
- cluster/host and cluster/port: Change this if you want to use another cluster server
- cluster/user: Enter here your call sign
- lotw/user: Enter here your lotw user name (your call sign)
- lotw/password: Enter here your lotw password
- lotw/mode: Enter here the mode you would like to filter the QSL download from LotW
- execute the application again with "colorspot"