https://github.com/ewpratten/cl

VA3ZZA CL amateur radio logging tool
https://github.com/ewpratten/cl

adif amateur-radio amateur-radio-logbook logging lotw rust rust-cli

Last synced: 4 days ago
JSON representation

VA3ZZA CL amateur radio logging tool

• Host: GitHub
• URL: https://github.com/ewpratten/cl
• Owner: ewpratten
• License: gpl-3.0
• Created: 2021-06-14T01:59:36.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2021-06-20T02:02:39.000Z (over 3 years ago)
• Last Synced: 2024-10-30T18:48:32.525Z (about 2 months ago)
• Topics: adif, amateur-radio, amateur-radio-logbook, logging, lotw, rust, rust-cli
• Language: Rust
• Homepage: https://crates.io/crates/cllog
• Size: 67.4 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CL

[![Crates.io](https://img.shields.io/crates/v/cllog)](https://crates.io/crates/cllog) 

[![Build](https://github.com/Ewpratten/cl/actions/workflows/build.yml/badge.svg)](https://github.com/Ewpratten/cl/actions/workflows/build.yml)

`cl` is my command-line amateur radio logging tool.

## Installation

`cl` can be installed via `cargo`:

```sh

cargo install cl

```

## Usage

`cl` is built up of sub-commands:

```

# $ cl --help

Evan Pratten 

VA3ZZA's CL amateur radio logging tool

USAGE:

    cl [SUBCOMMAND]

FLAGS:

    -h, --help       Prints help information

    -V, --version    Prints version information

SUBCOMMANDS:

    book     Tools for managing logbooks

    help     Prints this message or the help of the given subcommand(s)

    log      Manage log entries

    query    Look up existing logbook entries

```

### Import and export

`cl` can both import and export ADIF files. This is useful for data migration, and exporting to LOTW.

### Common commands

All commands will print their help message if run without arguments.

#### `cl log new`

Used to add a new entry to the logbook. Help info:

```

Create a new log entry

USAGE:

    cl log new [OPTIONS]  --frequency  --mode 

FLAGS:

    -h, --help       Prints help information

    -V, --version    Prints version information

OPTIONS:

    -d, --override-date        Specify a custom date for the log entry. Format yyyy-mm-dd

    -f, --frequency       QSO frequency in KHz (ex. 7030)

    -g, --gridsquare           The station's gridsquare

    -l, --logbook           Use a specific logbook

    -m, --mode                 Operating mode

    -n, --name                 Name of the station operator

        --notes               Any QSO notes

    -r, --rst-received     RST received from the other station

    -s, --rst-sent         RST sent to the other station

    -t, --override-time        Specify a custom time for the log entry

        --tx-pwr             Number of watts used for this QSO

ARGS:

        Callsign of the station you contacted

```

#### `cl query`

Used for looking up existing entries in a logbook. The callsign field excepts REGEX strings for easy searching. Help info:

```

Look up existing logbook entries

USAGE:

    cl query [FLAGS] --callsign  [logbook]

FLAGS:

    -h, --help          Prints help information

    -a, --search-all    Search all logbooks

    -V, --version       Prints version information

OPTIONS:

    -c, --callsign     Search by callsign

ARGS:

        Logbook to search (otherwise default or all)

```