NAME
cwgen - generate groups of random characters for Morse code practice
SYNOPSIS
cwgen [-g groups] [--groups=groups] [-n groupsize]
[--groupsize=groupsize] [-n group_min-group_max]
[--groupsize=group_min-group_max] [-r repeat] [--repeat=repeat] [-x
limit] [--limit=limit] [-c charset] [--charset=charset]
cwgen also accepts the -h, --help, -v and --version options.
The LINUX version understands both short form and long form command
line options. Other versions 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
--hz=850
SEE ALSO
Man pages for cw(7,LOCAL), cwlib(3,LOCAL), cw(1,LOCAL), cwcp(1,LOCAL),
and xcwcp(1,LOCAL).