Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ftl/hamdeck
Control and automate your ham radio station using an Elgato Stream Deck device.
https://github.com/ftl/hamdeck
amateur-radio amateurradio ham-radio hamradio streamdeck
Last synced: 1 day ago
JSON representation
Control and automate your ham radio station using an Elgato Stream Deck device.
- Host: GitHub
- URL: https://github.com/ftl/hamdeck
- Owner: ftl
- License: mit
- Created: 2020-07-31T18:25:29.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-12-19T10:31:55.000Z (11 months ago)
- Last Synced: 2024-06-19T18:12:27.218Z (5 months ago)
- Topics: amateur-radio, amateurradio, ham-radio, hamradio, streamdeck
- Language: Go
- Homepage:
- Size: 534 KB
- Stars: 16
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HamDeck
HamDeck allows you to control and automate your ham radio station using an Elgato Stream Deck device. You can define buttons using a JSON configuration file. HamDeck connects to the local pulseaudio server, to a Hamlib rigctld server, or to ExpertSDR through the TCI protocol. Currently the following actions are implemented as Stream Deck buttons:
* Toggle the mute state of a pulseaudio sink, source, sink input, or source output.
* Call any simple Hamlib set command (e.g. `vfo_op BAND_UP`).
* Set the mode of your radio through Hamlib or TCI.
* Switch to a specific frequency band through Hamlib or TCI.
* Set the output power level of your radio through Hamlib or TCI.
* Control the TX state (MOX) of your radio through Hamlib or TCI.
* Select the VFO of your radio through Hamlib.
* Get an indication on the mode buttons which modes are suitable to the current frequency according to the IARU Region 1 bandplan.
* Jump to the center of the closest band portion suitable for your currently selected mode (press the mode button > 1s).
* Control the major volume of ExpertSDR through TCI.
* Set a mode and a custom filter band through TCI.
This tool is written in Go on Linux. It might also work on OSX or Windows, but I did not try that out.
## Build
Binary data, e.g. icons, are stored in the sub-directories of `pkg/bindata`. All files are automatically embedded using the Go embed package (new with Go 1.16) when the `hamdeck` binary is compiled.
To build the `hamdeck` binary simply run
```
go build
```
## Configuration
HamDeck reads a JSON file on startup that must contain the definitions of all buttons. By default it uses the file `~/.config/hamradio/hamdeck.json`. The configuration file is not created automatically, you must create your configuration file manually. See [example_conf.json](./example_conf.json) for an example of a configuration file.
With the command line parameter `--config=` you can define an alternative configuration file. This is handy if you want to have several different setups of your Stream Deck (e.g. one for rag chewing and one for contest operation).
The buttons for Hamlib and TCI are only available if you provide a corresponding host address (and port if it deviates from the standard):
* Use the `--hamilb` command line parameter to connect to a Hamlib rigctld server (e.g. `--hamlib=localhost:4532`).
* Use the `--tci` command line parameter to connect to a ExpertSDR instance through the TCI protocol (e.g. `--hamlib=localhost:40001`).
You can have both connections open at the same time.
## Install from Source
The following describes the steps how to install `hamdeck` on an Ubuntu 20.04 LTS (Focal Fossa) to start automatically when you plug-in your the Stream Deck device.
1. Installing the binary:
```
go install github.com/ftl/hamdeck
which hamdeck
```
The last command will give you the path to the installed binary, which you will need later.
2. Adding UDEV rules for the stream deck
Create `/etc/udev/rules.d/99-hamdeck.rules` with the following content:
```
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0060", MODE:="666", GROUP="plugdev", SYMLINK="hamdeck", TAG+="systemd", ENV{SYSTEMD_WANTS}="hamdeck.service"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0063", MODE:="666", GROUP="plugdev", SYMLINK="hamdeck", TAG+="systemd", ENV{SYSTEMD_WANTS}="hamdeck.service"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="006c", MODE:="666", GROUP="plugdev", SYMLINK="hamdeck", TAG+="systemd", ENV{SYSTEMD_WANTS}="hamdeck.service"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="006d", MODE:="666", GROUP="plugdev", SYMLINK="hamdeck", TAG+="systemd", ENV{SYSTEMD_WANTS}="hamdeck.service"
ACTION=="remove", SUBSYSTEM=="usb", ENV{PRODUCT}=="fd9/60/*", TAG+="systemd"
ACTION=="remove", SUBSYSTEM=="usb", ENV{PRODUCT}=="fd9/63/*", TAG+="systemd"
ACTION=="remove", SUBSYSTEM=="usb", ENV{PRODUCT}=="fd9/6c/*", TAG+="systemd"
ACTION=="remove", SUBSYSTEM=="usb", ENV{PRODUCT}=="fd9/6d/*", TAG+="systemd"
```
(See [systemd devices](https://www.freedesktop.org/software/systemd/man/systemd.device.html) and [systemd #7587](https://github.com/systemd/systemd/issues/7587) for a little bit of background about the UDEV rules.)
3. Adding a service definition for `hamdeck`
Create `/etc/systemd/system/hamdeck.service` with the following content:
```
[Unit]
Description=HamDeck
After=syslog.target dev-streamdeck.device
BindsTo=dev-hamdeck.device
[Service]
ExecStart= --syslog --config=
```
## Install the DEB Package
Under [https://github.com/ftl/hamdeck/releases/latest](https://github.com/ftl/hamdeck/releases/latest) you find the latest release of HamDeck als DEB package. This can be used to install HamDeck on distributions that are based on Debian (e.g. Ubuntu). The package installs the following files:
* `/usr/bin/hamdeck` - the executable binary
* `/lib/systemd/system/hamdeck.service` - the systemd service definition
* `/lib/udev/99-hamdeck.rules` - the udev rules
* `/usr/share/hamdeck/example_conf.json` - an example configuration that is used by the systemd service by default
After installing the package, you should adapt `/lib/system/system/hamdeck.service` and `/usr/share/hamdeck/example_conf.json` according to your needs.
## Links
* [Wiki](https://github.com/ftl/hamdeck/wiki)
## License
This tool is published under the [MIT License](https://www.tldrlegal.com/l/mit).
This repository and also the binary contains images from [https://material.io](https://material.io/resources/icons/), which are licensed under the [Apache license version 2.0](https://www.apache.org/licenses/LICENSE-2.0.html).
This repository and also the binary contains the DejaVuSans font version 2.37 from [https://dejavu-fonts.github.io/](https://dejavu-fonts.github.io/), which is licensed under a [free license](https://dejavu-fonts.github.io/License.html).
Copyright [Florian Thienel](http://thecodingflow.com/)