CWGEN(1)

💖 CWGEN(1) — the manual page, but make it a group chat 💖

okay bestie, welcome to cwgen, section 1 of the General Commands Manual. it's a little tool that spits out random character groups so you can practice your Morse code. yes, that Morse code. the beepy one. 🎀

---

✨ 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]

so, if you've got cwgen installed on a GNU/Linux system, it's bilingual — it understands both the short form and the long form command line options. 💅 but if it's installed on some other operating system, it might only understand the short form options. that's just how it is, no cap.

also!! options can be predefined in the environment variable CWGEN_OPTIONS. if that's defined, those options get used first, and then command line options take precedence. so the command line always gets the last word. main character energy, honestly. 👑

---

💜 DESCRIPTION 💜

cwgen is the simple way to generate groups of random characters that you can pipe straight into cw. the command line options control the group size, the number of groups, and the character set the random characters get pulled from. that's the whole vibe. 🫶

🎀 COMMAND LINE OPTIONS 🎀

here's everything cwgen understands. heads up: the long form options might not be available in non-LINUX versions, so if you're on some other system and the long form ghosts you, that's why. 😭

• -g, --groups — how many groups of random characters to generate. default is 128. 🔥
• -n, --groupsize — the number of random characters in each group. give it one single value and every group is that size. give it a dash-separated pair of values and it's a range — cwgen will randomly size each group somewhere between group_min and group_max. default is 5. ✨
• -r, --repeat — how many times to repeat each group. default is 0, which means each group gets printed just once. periodt.
• -x, --limit — an upper limit on the number of characters printed. this one is lowkey a lifesaver when you're using random group sizes, because it guarantees you a given amount of practice text. default is 0, meaning there's no upper limit at all. 💀
• -c, --charset — the character set the random characters are selected from. default value is 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'. that's the alphabet in caps plus the digits, in case you were wondering. 🍓
• -h, --help — help.
• -V, --version — version.

---

🌈 EXAMPLES 🌈

let's say you want 20 groups of 10 characters from the set EISH5, and you want to actually hear them as Morse code. both the short-form and long-form versions are here, because we're thorough like that:

cwgen -g 20 -n 10 -c "EISH5" | cw -w 25 -t 850

cwgen --groups=20 --groupsize=10 --charset="EISH5" | cw --wpm=25
--tone=850

look at that pipe. chef's kiss. 🧚

---

⭐ SEE ALSO ⭐

the man pages for cw(7,LOCAL), libcw(3,LOCAL), cw(1,LOCAL), cwcp(1,LOCAL), and xcwcp(1,LOCAL). go read them, they're iconic too. 👑

---

that's the whole page, bestie!! this was cwgen ver. 3.6.1 from the CW Tutor Package, and yeah, it lives in section CWGEN(1) of the manual. now go make some beeps. 💖🎀✨