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.


  • 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.

Task List

  • 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 missing frequencies to current Aoki table using the EiBi data.

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.
  • Create a script to update the frequency table from a downloaded file.

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.

Project details

Release history Release notifications

Download files

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

Files for swtools, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size swtools-1.0.0-py3-none-any.whl (691.2 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size swtools-1.0.0.tar.gz (24.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page