bmitch / hrt

Ham Radio command line tools

hrt - ham radio terminal

hrt is a simple terminal based application aimed at providing various tools for Amateur Radio operators.

Installation

Currently while in early development stage you will need Rust and Cargo installed to run hrt

cargo install hrt

Config

After installing, run the config generator:

hrt init

This will create a .hrt.toml file in your home directory and output the path to it. Open this file up with an editor (vim, nano, notepad, VS Code, etc.) and set the config values for the commands you plan to use.

Commands

To see a list of all available commands, simply run hrt without any arguments.

Callsign lookup

You will need to set your account info in .hrt.toml for qrz and/or hamqth.

Lookup with QRZ:

hrt call C4LLS1GN

example output:

C4LLS1GN (QRZ)
  Name: Nikola Tesla
  Location: Colorado Springs, CO, United States
  Class: E

Use alternative lookup source HamQTH:

hrt call C4LLS1GN -s hamqth

example output:

c4lls1gn (HamQTH)
  Name: Nikola Tesla
  Location: Colorado Springs, CO, United States

Call command arguments will be added to allow returning additional information.

DXCC lookup

You will need to set your account info in .hrt.toml for qrz. No account info needed for hamqth DXCC lookups.

Lookup by entity code / adif number with QRZ:

hrt dxcc 291

example output:

291 (QRZ)
  Name: United States
  ITU: 0
  CQ: 0
  UTC: -5

Use alternative lookup source HamQTH:

hrt dxcc 291 -s hamqth

example output:

291 (HamQTH)
  Name: United States
  ITU: 8
  UTC: 5
  Details:

Lookup by callsign

hrt dxcc C4LLS1GN

example output:

291 (QRZ)
  Country: United States
  ITU: 0
  CQ: 0
  UTC: -5

Use alternative lookup source HamQTH:

hrt dxcc C4LLS1GN -s hamqth

example output:

291 (HamQTH)
  Name: United States
  ITU: 07
  UTC: 7
  Details: USA - CO,IA,KS,MN,MO,ND,NE,SD

Contributing

Feature requests, bug reports, and pull requests are welcome on GitHub at https://github.com/beaorn/hrt.

License

Licensed under the MIT License.