The original FLE format was extented with release V1.4 to support POTA log files.
This tool is intended to process FLE formatted files on other platform than Windows. The FLE input file format is described on https://www.df3cb.com/fle/documentation/
This tool is intended to process FLE formatted files on other platform than Windows. The FLE input file format is described on <https://www.df3cb.com/fle/documentation/>
------
If you like what I did and want to keep me going, you can "buy me a coffee" via the link below.
If you like what I did and want to keep me going, you can "buy me a coffee" via the link below.
[](https://www.buymeacoffee.com/on4kjm)
[](https://www.buymeacoffee.com/on4kjm)
------
## Installing
The tool is installed by downloading and unpacking the archive for your operating system.
A version is available for Windows, MacOS, Linux and ARM (RaspberryPi).
A version is available for Windows, MacOS, Linux and ARM (RaspberryPi).
Most of them are available as 32 or 64 bit applications.
A docker version is also available.
The releases can be downloaded from https://github.com/on4kjm/FLEcli/releases
The releases can be downloaded from <https://github.com/on4kjm/FLEcli/releases>
For MacOS users, `homebrew` is the easiest installation method.
* add the Homebrew tap with `brew tap on4kjm/tap`.
* add the Homebrew tap with `brew tap on4kjm/tap`.
* install the application with `brew install flecli`.
Detailed installation instructions for:
Detailed installation instructions can be found [at this page](doc/install.md).
* [Windows, Linux, and ARM](doc/install.md)
* [mac](doc/install_mac.md)
## Usage
Detailed explanations can be found [on this page](doc/usage.md).
See [Detailed FLEcli command usage](doc/usage.md).
Most common use cases are described hereafter as examples.
@ -48,35 +49,38 @@ Most common use cases are described hereafter as examples.
To load and validate the FLE formatted file (`myActivation.txt`):
```
```shell
./FLEcli load myActivation.txt
```
This command will parse and display the QSOs in grid format.
Fields that couldn't be successfully parsed are prefixed with "*".
Parsing errors or doubts are listed at the end of the list.
This command will parse and display the QSOs in grid format.
Fields that couldn't be successfully parsed are prefixed with "*".
Parsing errors or doubts are listed at the end of the list.
### Example: generate an ADIF file
To generate an ADIF file based on `activation.txt`:
The application can be downloaded from the latest release page, found at https://github.com/on4kjm/FLEcli/releases.
The application can be downloaded from the latest release page, found at <https://github.com/on4kjm/FLEcli/releases>.
The application is available in the following packaging:
* `FLEcli_v..._macOS_64-bit.tar.gz` is the MacOS version.
* `FLEcli_v..._windows_32-bit.zip` is the Windows version. Only the 32 bit is proposed as it should work also on older Windows version.
* `FLEcli_v..._Linux_64-bit.tar.gz` is the 64 bits distribution for Linux.
@ -15,19 +16,23 @@ The application is available in the following packaging:
After downloading the appropriate archive, you can validate its sha256 and compare it with the value in the `checksum.txt` file.
## Compiling
The application can also be compiled from sources if Golang is available. How to proceed is out of the scope of this notice.
## Installing
Unpack it in a convenient location. Depending on your Operating System, you can make it available from any location:
Unpack it in a convenient location. Depending on your Operating System, you can make it available from any location:
* Adding the directory to the path for Windows
* Creating a (permanent) alias on Linux or MacOS
* Moving the executable to a directory that is in the path, such as `/usr/local/bin` for Linux or MacOs.
### HomeBrew
Currently there is no Homebrew installation available.
See the [installation on mac documentation](install_mac.md)
### Docker
The application is also available as a docker container.
It can be started with: `docker run --rm -i --user $(id -u):$(id -g) -v $(pwd):/FLEcli_data on4kjm/flecli <FLEcli command>`. If no command is specified, help is displayed.
To avoid typing the whole command, an alias is recomended as described in the [docker specific instructions](../docker/README.md).
@ -36,6 +41,6 @@ To avoid typing the whole command, an alias is recomended as described in the [d
### MacOS
**WARNING:** at this stage, the MacOS binary is not signed. It will fail to load on the recent OS version unless a very permissive security setting is enable (which is not advised).
**WARNING:** at this stage, the MacOS binary is not signed. It will fail to load on the recent OS version unless a very permissive security setting is enable (which is not advised).
Please find [here a detailed procedure](install_mac.md) to use FLEcli on a Mac despite the missing signature.
Please see the [installation on a mac documentation](install_mac.md) to use FLEcli on a Mac despite the missing signature.
* add the Homebrew tap with `brew tap on4kjm/tap`.
* add the Homebrew tap with `brew tap on4kjm/tap`.
* install the application with `brew install flecli`.
## Manual installation
@ -15,21 +15,21 @@ This procedure will guide you for adding FLEcli to the exception list.
When the executable has been unpacked in a directory and that you try to execute it in the console (`./FLEcli`), you will get the following error:
Make sure that you choose "cancel" to close the dialog.
Having triggered that error will allow you to enable the exception.
Enter the "system preference" and choose the "Security Settings".
On the "general" tab, you will see the problem that just occurred ( _"FLEcli" was blocked from use because it is not from an identified developer_ ). Click on the "Allow Anyway" button.
When trying again to execute the application, the error message will be slightly different:
But this time, choose "open". The exception is now registered.
But this time, choose "open". The exception is now registered.
Use "FLEcli [command] --help" for more information about a command.
```
## "LOAD" command
```
```text
Loads and validates a FLE type shorthand logfile
Usage:
@ -37,10 +37,10 @@ Flags:
Global Flags:
--config string config file (default is $HOME/.FLEcli.yaml)
```
## "ADIF" command
```
```text
Generates an ADIF file based on a FLE type shorthand logfile.
Usage:
@ -57,10 +57,10 @@ Flags:
Global Flags:
--config string config file (default is $HOME/.FLEcli.yaml)
```
## "CSV" command
```
```text
Generates a SOTA .csv file based on a FLE type shorthand logfile.
Usage:
@ -74,10 +74,10 @@ Flags:
Global Flags:
--config string config file (default is $HOME/.FLEcli.yaml)
```
## "VERSION" command
```
```text
"version" will output the current build information
Usage:
@ -90,4 +90,5 @@ Flags:
Global Flags:
--config string config file (default is $HOME/.FLEcli.yaml)
```
The normal output looks like `FLEcli version: v0.1.2`. The detailled output gives additionaly the Git commit hash. the date and time of build and who built the release.
* Fix "S2S contacts not recognized properly" (issue #78)
## Previous releases
### v0.1.4
@ -14,8 +13,6 @@
* Frequency can now be specified up to 500Hz without truncation (issue #71)
* Enabled Homebrew distribution
### v0.1.3
* Enable FLEcli to generate CSV chaser logs
@ -33,12 +30,15 @@
* Correct some typos and bugs
### v0.1.1
* Improved test coverage
* Improved build automation
* Improved release notes publication
### v0.1.0
* First public MVP (Minimal Viable Product relase). Supports only SOTA and WWFF type log files. Some header keywords are missing as well as date increments.
Bryan Nehl
2 years ago
committed by
GitHub