1CWGEN(1) General Commands Manual CWGEN(1)
2
3
4
6 cwgen - generate groups of random characters for Morse code practice
7
9 cwgen [-g groups] [--groups=groups] [-n groupsize] [--groupsize=group‐
10 size] [-n group_min-group_max] [--groupsize=group_min-group_max] [-r
11 repeat] [--repeat=repeat] [-x limit] [--limit=limit] [-c charset]
12 [--charset=charset]
13
14 cwgen also accepts the -h, --help, -v and --version options.
15
16 The LINUX version understands both short form and long form command
17 line options. Other versions may understand only the short form
18 options.
19
20 Options may be predefined in the environment variable CWGEN_OPTIONS.
21 If defined, these options are used first; command line options take
22 precedence.
23
25 cwgen provides a simple method to generate groups of random characters
26 for use as input into cw. Command line options control the group size,
27 number of groups, and character set from which the random characters
28 are selected.
29
30 COMMAND LINE OPTIONS
31 cwgen understands the following command line options. The long form
32 options may not be available in non-LINUX versions.
33
34 -g, --groups
35 Specifies the number of groups of random characters to generate.
36 The default value is 128.
37
38 -n, --groupsize
39 Specifies either the number of random characters in each group,
40 if a single value is given, or a range for the number of random
41 characters in each group if a dash-separated pair of values is
42 given. If a range is given, cwgen generates groups sized ran‐
43 domly between 'group_min' and 'group_max'. The default value is
44 5.
45
46 -r, --repeat
47 Specifies the number of times to repeat each group. The default
48 value is 0, indicating that each group is printed just once.
49
50 -x, --limit
51 Specifies an upper limit on the number of characters printed.
52 This option is useful when using random group sizes, to ensure a
53 given amount of practice text. The default value is 0, indicat‐
54 ing no upper limit on the number of characters printed.
55
56 -c, --charset
57 Defines the character set from which the random characters are
58 selected. The default value is 'ABCDEFGHIJKLMNOPQRSTU‐
59 VWXYZ0123456789'.
60
62 Generate 20 groups of 10 characters from the set EISH5, and sound them
63 as Morse code. Both short-form and long-form option examples are
64 shown:
65
66 cwgen -g 20 -n 10 -c "EISH5" | cw -w 25 -t 850
67
68 cwgen --groups=20 --groupsize=10 --charset="EISH5" | cw --wpm=25
69 --hz=850
70
72 Man pages for cw(7,LOCAL), cwlib(3,LOCAL), cw(1,LOCAL), cwcp(1,LOCAL),
73 and xcwcp(1,LOCAL).
74
75
76
77G0FRD CW Tutor Package CWGEN(1)