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>

welle-cli 2.4                                     November 2021                                     WELLE-CLI(1)