cwgen(1)

cwgen1

Generate groups of random characters for morse code practice

Usage

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]

Overview

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

Releases

14 releases since Debian 2.1 (Slink); the text changed 9 times.

  1. 2.1–2.2
  2. 3.0
  3. 3.1
  4. 4.0–6.0
  5. 7
  6. 8
  7. 9
  8. 10–11
  9. 12
  10. 13

--limit since Debian 4.0 (Etch); --repeat since Debian 4.0 (Etch); -r since Debian 4.0 (Etch); -x since Debian 4.0 (Etch).

From cw 3.6.1-2+b1 in Debian 13 (Trixie). Parsed by carta from the page's man source.