---
name: "welle-cli"
section: "1"
platform: "linux"
package: "welle.io"
version: "2.4+ds-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/welle-cli"
---

# welle-cli(1)

welle.io command line interface

## NAME

welle-cli - welle.io command line interface

## SYNOPSIS

**welle-cli** \[*OPTION*\]\
 **welle-cli** *-w \<port\>* \[*OPTION*\]

## DESCRIPTION

welle-cli is welle.io's command line interface.

## OPTIONS

### Tuning:

- **-c** channel

  Tune to \<channel\> (eg. 10B, 5A, LD...).

- **-p** programme

  Play \<programme\> with ALSA (text name of the radio: eg. GRIFF).

### Dumping:

- **-D**

  Dump FIC and all programmes to files (cannot be used with **-C**). This generates: dump.fic; \<programme\_name.msc\> files; \<programme\_name.wav\> files.

- **-d**

  Dump programme to \<programme\_name.msc\> file.

### Web server mode:

- **-w** port

  Enable web server on port \<port\>.

- **-C** number

  Number of programmes to decode in a carousel (to be used with **-w**, cannot be used with **-D**). This is useful if your machine cannot decode all programmes simultaneously, but you still want to get an overview of the ensemble.

- **-P**

  Without the **-P** option, welle-cli will switch every 10 seconds. With the **-P** option, welle-cli will switch once DLS and a slide were decoded, staying at most 80 seconds on a given programme.

### Backend and input options:

- **-f** file

  Read an IQ file \<file\> and play with ALSA IQ file format is u8, unless the file ends with FORMAT.iq

- **-u**

  Disable coarse corrector, for receivers who have a low frequency offset.

- **-g** gain

  Set input gain to \<gain\> or **-1** for auto gain.

- **-F** driver

  Set input driver and arguments. Default: "auto". Valid drivers depending on compilation options at build time are: airspy, rtl\_sdr, android\_rtl\_sdr, rtl\_tcp, soapysdr. With "rtl\_tcp", host IP and port can be specified as "rtl\_tcp,\<HOST\_IP\>:\<PORT\>".

- **-s** args

  SoapySDR Driver arguments.

- **-A** antenna

  Set input antenna to ANT (for SoapySDR input only).

- **-T**

  Disable TII decoding to reduce CPU usage.

### Other options:

- **-t** test\_id

  Run test \<test\_id\>. To understand what the tests do, please see source code.

- **-h**

  Display this help and exit.

- **-v**

  Output version information and exit.

## EXAMPLES

welle-cli -c 10B -p GRRIF

-

  Receive 'GRRIF' on channel '10B' using 'auto' driver, and play with ALSA.

welle-cli -f ./ofdm.iq -p GRRIF

-

  Read IQ file './ofdm.iq' (in u8 format) and play programme 'GRIFF' with ALSA.

welle-cli -f ./ofdm.iq -t 1

-

  Read IQ file './ofdm.iq' (in u8 format), and run test 1.

welle-cli -c 10B -D

-

  Dump FIC and all programmes of channel 10B to files.

welle-cli -c 10B -w 8000

-

  Enable web server on port 8000, decode programmes on channel 10B on demand (http://localhost:8000).

welle-cli -c 10B -Dw 8000

-

  Enable web server on port 8000, decode all programmes on channel 10B.

welle-cli -c 10B -C 1 -w 8000

-

  Enable web server on port 8000, decode programmes one by one in a carousel on channel 10B; welle-cli will switch every 10 seconds.

welle-cli -c 10B -PC 1 -w 8000

-

  Enable web server on port 8000, decode programmes one by one in a carousel on channel 10B; welle-cli will switch once DLS and a slide were decoded, staying at most 80 seconds on a given programme.

## AUTHOR

Written by: Albrecht Lohofener & Matthias P. Braendli. Other contributors: \<https://github.com/AlbrechtL/welle.io/blob/master/AUTHORS\>

## REPORTING BUGS

Report bugs to: \<https://github.com/AlbrechtL/welle.io/issues\>

## COPYRIGHT

Copyright © 2018 Matthias P. Braendli.\
 Copyright © 2017 Albrecht Lohofener. License GPL-2.0-or-later: GNU General Public License v2.0 or later \<https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html\>