a colorized cli DX cluster client
Go to file
Michael Clemens b0fd84337f fixed readme 2022-05-20 18:52:06 +02:00
src/colorspot version increment 2022-05-20 18:46:57 +02:00
LICENSE.md added LICENSE 2022-05-20 17:12:55 +02:00
README.md fixed readme 2022-05-20 18:52:06 +02:00
screenshot.png changed screenshot 2022-05-20 17:16:39 +02:00
setup.cfg version increment 2022-05-20 18:46:57 +02:00
setup.py added setup.py 2022-05-20 17:29:19 +02:00

README.md

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 (optional)
  • displays lines in different colors depending on the continent or band (user configurable)

Screnshot

screenshot

Limitations

The following limitations are present:

  • read-only: you can't send commands to the dx cluster server via this tool
  • no filters: you need to configure your filter on the server

Installation

ColorSpot needs Python 3 and the following libraries:

  • colored
  • requests

Furthermore, you need an account at LotW for some of the 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. ~/.config/colorspot/colorspot.ini)
  • adapt ~/.config/colorspot/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). 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
  • execute the application again with "colorspot"

License

see LICENSE