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 --force

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 K0NYX

example output:

+----------+------------------------+
| Callsign | K0NYX                  |
+----------+------------------------+
| Name     | Bryce Johnston         |
+----------+------------------------+
| Aliases  | KE0TSN                 |
+----------+------------------------+
| Email    | bryce@beaorn.com       |
+----------+------------------------+
| Address  | PO BOX 000             |
+----------+------------------------+
| Location | Manhattan, KS 66502    |
+----------+------------------------+
| Country  | United States          |
+----------+------------------------+
| Class    | General                |
+----------+------------------------+
Source: QRZ

Use alternative lookup source HamQTH:

hrt call K0NYX -s hamqth

example output:

+----------+------------------------+
| Callsign | K0NYX                  |
+----------+------------------------+
| Name     | Bryce Johnston         |
+----------+------------------------+
| Email    | bryce@beaorn.com       |
+----------+------------------------+
| Location | Manhattan, KS 66502    |
+----------+------------------------+
| Country  | United States          |
+----------+------------------------+
Source: HamQTH

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:

+------+---------------+
| DXCC | 291           |
+------+---------------+
| Name | United States |
+------+---------------+
| ITU  | 0             |
+------+---------------+
| CQ   | 0             |
+------+---------------+
| UTC  | -5            |
+------+---------------+
Source: QRZ

Use alternative lookup source HamQTH:

hrt dxcc 291 -s hamqth

example output:

+---------+---------------+
| ADIF    | 291           |
+---------+---------------+
| Name    | United States |
+---------+---------------+
| ITU     | 8             |
+---------+---------------+
| UTC     | 5             |
+---------+---------------+
| Details |               |
+---------+---------------+
Source: HamQTH

Lookup by callsign

hrt dxcc K0NYX

example output:

+------+---------------+
| DXCC | 291           |
+------+---------------+
| Name | United States |
+------+---------------+
| ITU  | 0             |
+------+---------------+
| CQ   | 0             |
+------+---------------+
| UTC  | -5            |
+------+---------------+
Source: QRZ

Use alternative lookup source HamQTH:

hrt dxcc K0NYX -s hamqth

example output:

+---------+-------------------------------+
| ADIF    | 291                           |
+---------+-------------------------------+
| Name    | United States                 |
+---------+-------------------------------+
| ITU     | 07                            |
+---------+-------------------------------+
| UTC     | 7                             |
+---------+-------------------------------+
| Details | USA - CO,IA,KS,MN,MO,ND,NE,SD |
+---------+-------------------------------+
Source: HamQTH

Contributing

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

License

Licensed under the MIT License.