Skip to main content

Shortwave CLI tools for SWLing and DXing!

Project description Documentation Status

Shortwave CLI tools for SWLing and DXing!


SWLookup is a command line tool to lookup shortwave frequency data. Easily lookup a frequency by following the prompts. Local time is optional but recommended for more accurate results.


SWLing is the command line companion tool to SWLookup. It features a simple menu with pre-built reports to analyze shortwave listening data to highlight top stations, transmitters, and frequencies. The reports are built using the data saved to a CSV file with while using the SWLookup application.


SWUpdate is a command line companion tool to SWLookup. It allows the update of the shortwave frequency table. Simple run and pick an update file.


  • Lookup schedules for a frequency with optional local time.

  • Save shortwave listening session information to a CSV file.

  • View shortwave listening history for the current frequency.

  • View shortwave listening highlights with SWLing reports.

  • Update the shortwave frequency table.

Task List and OFI’s

  • Move colorize from to

  • Remove first_digit from

  • Import first_digit and colorize from instead of static methods in

  • Refactor report paramaters implementation in to use the Prompter class.

  • Add column for trasnmitter power in history lookup.

  • Publish documentation to Read The Docs.

Planned Features

  • Add a new report that lists everything on-air in the xx band for current time and weekday.

  • Add a new report to search for a station or program.

  • Add dBu quality measurements table and translate to S meter values for diplay.

Data Disclaimer

At first this tool used the EiBi frequency data. However, since 2019-12-06 it was changed to use the Aoki BI Newsletter data as the main frequency lookup table. The main reason for the change was that the data is much simpler to work with. Despite the cons, I felt the data is more maintainable and easier to update as required. The plan is to eventually merge the two lists.

Aoki Pros

  • The data is updated more often with program schedule changes

  • It simplifies the SQL by eliminating the need for joins to use different code tables

  • The station column usually contains the name AND the program simplifying listening discovery

  • The days of operation column uses a more consitent data format

  • The transmitter location and it’s geocoordinates are in separate columns

Aoki Cons

  • There are less frequencies listed (ex: time signal stations are not included)

  • There is no target area information for transmitters

  • There is no state/country information for the transmitter location

Please note that this data is free and comes with absolutely no guarantees.


Shortwave schedules are from Aoki’s excellent (and free!) Bi Newsletter.

Additional information from the excellent (and free!) EiBi Shortwave Schedules.

ASCII art logos created with the free Text to ASCII Art Generator (TAAG) tool using the slant FIGlet font.

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


1.0.0 (2019-12-27)

  • Initial release.

1.1.0 (2020-04-06)

  • Minor release adding updater.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

swtools-1.1.0.tar.gz (27.3 kB view hashes)

Uploaded source

Built Distribution

swtools-1.1.0-py3-none-any.whl (413.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page