General and WSPR Options

General Options

  • -h, --help
    Display help text and exit. This is processed early and does not require root.

  • -v, --version
    Print version information and exit.

  • -i, --ini-file <file>
    Load configuration from an INI file. When used, CLI transmission options are disabled or restricted, and the program runs in daemon-style mode.

  • -r, --repeat
    Repeat transmissions indefinitely in direct CLI mode.

  • -x, --terminate <count>
    Stop after a specified number of transmissions.

  • -J, --journald
    Send logs to the systemd journal instead of stdout.

  • -D, --date-time-log
    Prefix log lines with UTC timestamps.

  • --debug-logging, --no-debug-logging
    Enable or disable debug-level logging output.

WSPR Behavior

  • --planner-preference <auto\|prefer_paired\|require_paired>
    Controls WSPR message planning. The default auto mode uses a normal single WSPR frame when possible and allows the planner to choose paired handling when needed. prefer_paired asks the planner to use paired handling when it is available. require_paired rejects a transmission if the supplied identity cannot be represented with the paired-message strategy.

  • -o, --offset
    Apply a small random frequency offset to reduce collisions.

  • --no-offset
    Disable random offset.

WSPR Message Types

The CLI is no longer limited to classic Type 1-only callsign handling. Direct CLI WSPR input is passed through the same WSPR planning path used by the rest of the application.

  • Type 1 is the normal single-frame WSPR message form for standard callsign, grid, and power combinations.

  • Type 2 supports compound or extended identity cases by transmitting a callsign-hash-oriented frame as part of a paired strategy.

  • Type 3 supports the complementary extended identity information needed for paired decoding.

For ordinary callsigns and four-character grid squares, no special option is usually needed. For identities that require Type 2/Type 3 handling, use --planner-preference when you want to prefer or require paired planning.