Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ftl/hellocontest
A simple HF contest log for Linux, written in Go
https://github.com/ftl/hellocontest
adif amateur-radio amateurradio cabrillo contest contest-logger contesting cwdaemon gotk3 ham-radio hamlib hamradio hf-contest-log tci
Last synced: about 1 month ago
JSON representation
A simple HF contest log for Linux, written in Go
- Host: GitHub
- URL: https://github.com/ftl/hellocontest
- Owner: ftl
- License: mit
- Created: 2018-05-26T13:25:50.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-15T15:07:17.000Z (3 months ago)
- Last Synced: 2024-09-15T23:45:15.890Z (3 months ago)
- Topics: adif, amateur-radio, amateurradio, cabrillo, contest, contest-logger, contesting, cwdaemon, gotk3, ham-radio, hamlib, hamradio, hf-contest-log, tci
- Language: Go
- Homepage:
- Size: 1.12 MB
- Stars: 3
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/ftl/hellocontest/actions/workflows/ci.yml)
# Hello Contest
A simple HF contest log for Linux, written in Go using [gotk3](https://github.com/gotk3) for the UI. As I'm using this only for CW contests on HF, the program might not be very useful for other modes or higher frequencies. Anyway, here are some highlights:
* Calculate points, multis, and score per band and overall. The calculation is done using the [conval](https://github.com/ftl/conval) library. You can select the contest definition in the settings dialog (File > Settings).
* Show the current rate of QSOs, points, and multis in a comprehensive graphic.
* Export the logbook as [Cabrillo](https://wwrof.org/cabrillo/), [ADIF](http://adif.org), CSV, or call history.
* Get additional information about the entered callsign from the [DXCC](http://www.country-files.com) and [super check partial](http://supercheckpartial.com) databases, or a call history file.
* Use a call history file from a former contest to predict the exchange for the currently entered callsign.
* Use a dx cluster or a local CW skimmer and show the spotted stations in a spot list (or even the spectrum view of your radio, if it supports the [TCI protocol](https://github.com/maksimus1210/TCI)).
* Define different CW macros for the running and the search&pounce working mode.
* Use the [TCI protocol](https://github.com/maksimus1210/TCI), the [Hamlib daemon](https://github.com/Hamlib/Hamlib), or the [cwdaemon](https://github.com/acerion/cwdaemon) to transmit CW macros.
* Connect to your transceiver through the [TCI protocol](https://github.com/maksimus1210/TCI) or the [Hamlib network protocol](https://github.com/Hamlib/Hamlib) to keep the band and mode information in sync.
* Show the currently worked station on [F5UII's HamDXMap](https://dxmap.f5uii.net/).
## Known Issues
In combination with wayland, the "new contest" dialog does not work properly *sometimes*: you cannot select anything and the entry field for the contest name does not respond to any input. I found no hint so far, what the causes this behavior. If you have problems running Hello Contest in combination with wayland, please switch to X11. If you have any hints, what could be the cause of this behavior, please don't hesitate to contact me.
## Install
See also the [installation](https://github.com/ftl/hellocontest/wiki/Installation) wiki page for more details.
### AppImage
Download the AppImage of the latest release [here](https://github.com/ftl/hellocontest/releases/latest/).
### Debian, Ubuntu, etc.
Download the Debian package of the latest release [here](https://github.com/ftl/hellocontest/releases/latest/).
### Arch
The latest release of Hello Contest is available as AUR package: [hellocontest](https://aur.archlinux.org/packages/hellocontest).
## Build
Build hellocontest using the included Makefile by simply running
```
make
```
The following libraries are required:
* libgtk-3-0
* libgtk-3-dev
* libpango-1.0-0
* libpango1.0-dev
* libpangocairo-1.0-0
### gtk+3.0
To build the software on your system with the gotk3 library, you may need to set a tag with the version number of gtk+3.0 that is installed on your system:
```
# find out the version number
pkg-config --modversion gtk+-3.0
# build hellocontest (example for gtk+ 3.22.30)
go build -tags gtk_3_22
```
### Protobuf
Hellocontest uses Google's [protocol buffers](https://developers.google.com/protocol-buffers/) to define the data format of the log data stored on disk. The proto definition of the data format resides in the `core/pb` package. This package also contains the generated Go code to access the binary logbook data according to the proto definition. If you make any changes to the proto definition, you need to regenerate this code. The code generation is done using Google's `protoc` compiler for protocol buffers (see Google's [documentation on protocol buffers](https://developers.google.com/protocol-buffers/) for more information about how to install this tool). To run the code generation simply execute
```
make generate
```
This will generate the Go code to access the binary data in the logbook files into the `core/pb` package.
### Glade
The UI is defined using a Glade file. This file is automatically integrated into the executable by the Go compiler, using Go's `embed` package (new in 1.16).
## License
This software is published under the [MIT License](https://www.tldrlegal.com/l/mit).
Copyright [Florian Thienel](http://thecodingflow.com/)