This is an Electron-based desktop application that provides a dashboard view of an HF Ham Radio.
It uses (and requires the separate installation of) the hamlib Ham Radio Control Library.
Specifically, RigClient communicates over IP with either the rigctl
application or the rigctld
daemon, which in turn communicate with the radio via CAT Control, usually via either USB or serial port.
Currently, RigClient displays the current local and UTC times, the current VFO Frequency and mode, and the received signal strength (S-Meter). Additional features will likely be added as time allows.
Before you can run RigClient, you must have either rigctl or preferrably rigctld running and set up properly for your radio.
Please refer to the hamlib website for help in setting it up with your radio.
If you are running RigClient on the same computer as rigctl/rigctld, then you can just run the application with no configuration.
If you are running RigClient on another computer, it will need to communicate with rigctl/rigctld over the network, and so must be told the hostname, by adding the command-line argument
--host=x.x.x.x
where x.x.x.x
is replaced with the IP address of the computer running rigctl/rigctld.
So, for example, if the computer running rigctl/rigctld has the IP address of 192.168.1.100, you would run rigclient --host=192.168.1.100
If you have changed the port number that rigctl/rigctld listens on to something other than the default port of 4532, you must also specify the port with the --port
argument.
When run the first time, RigClient attempts to size its window to a reasonable size, and places it in the middle of the screen. Adjust the size and place it where you wish, and it will re-open at that size and position the next time you open it.
Builds are available for Mac OS, Windows, Linux x86, and Raspberry Pi (arm7) at https://github.com/rfreedman/rig-client/releases/tag/v0.1.3
Source code can be found at https://github.com/rfreedman/rig-client
Bug reports and pull requests welcome.