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).

cwgen ver. 3.6.0                                CW Tutor Package                                        CWGEN(1)