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