NAME

       cwgen - generate groups of random characters for Morse code practice

SYNOPSIS

       cwgen      [-g --groups=groups]      [-n --groupsize=groupsize]      [-n --groupsize=group_min-group_max]
       [-r --repeat=repeat] [-x --limit=limit] [-c --charset=charset]  [-h --help] [-V --version]

       cwgen installed on GNU/Linux systems understands both short form and  long  form  command  line  options.
       cwgen installed on other operating systems may understand only the short form options.

       Options  may be predefined in the environment variable CWGEN_OPTIONS.  If defined, these options are used
       first; command line options take precedence.

DESCRIPTION

       cwgen provides a simple method to generate groups of random characters for use as input into cw.  Command
       line options control the group size, number of groups, and character set from which the random characters
       are selected.

   COMMAND LINE OPTIONS
       cwgen understands the following command line options.  The long form options may not be available in non-
       LINUX versions.

       -g, --groups
              Specifies the number of groups of random characters to generate.  The default value is 128.

       -n, --groupsize
              Specifies  either  the number of random characters in each group, if a single value is given, or a
              range for the number of random characters in each group if a  dash-separated  pair  of  values  is
              given.   If  a  range  is  given,  cwgen  generates  groups sized randomly between 'group_min' and
              'group_max'.  The default value is 5.

       -r, --repeat
              Specifies the number of times to repeat each group.  The default value is 0, indicating that  each
              group is printed just once.

       -x, --limit
              Specifies  an  upper  limit on the number of characters printed.  This option is useful when using
              random group sizes, to ensure a given amount of practice text.  The default value is 0, indicating
              no upper limit on the number of characters printed.

       -c, --charset
              Defines  the  character  set  from which the random characters are selected.  The default value is
              'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'.

EXAMPLES

       Generate 20 groups of 10 characters from the set EISH5, and sound them as Morse  code.   Both  short-form
       and long-form option examples are shown:

              cwgen -g 20 -n 10 -c "EISH5" | cw -w 25 -t 850

              cwgen --groups=20 --groupsize=10 --charset="EISH5" | cw --wpm=25 --tone=850

SEE ALSO

       Man pages for cw(7,LOCAL), libcw(3,LOCAL), cw(1,LOCAL), cwcp(1,LOCAL), and xcwcp(1,LOCAL).