ebook2cw(1)

💖 ebook2cw(1) — the manual, but make it slay 💖

User Manuals, bestie. This is the page for ebook2cw, and yes we're doing the whole thing, every flag, no skips, no cap. 🎀

---

✨ NAME ✨

ebook2cw — turn your ebooks into Morse code audio files (MP3/OGG) 🦋

---

✨ SYNOPSIS ✨

ebook2cw [OPTIONS] [INFILE]

---

✨ DESCRIPTION ✨

Okay so ebook2cw is a command line program that takes a plain text ebook and converts it into Morse code audio files. It runs on several platforms, including Windows and Linux. 💅

A whole bunch of CW and audio parameters can be changed from their default values — either with command line switches or with a config file (more on that below). These are the ones, with the default values chillin' in brackets:

• -w wpm — CW speed in words per minute [25]
• -e wpm — Effective CW speed. If you set this, the spaces get sent at this speed instead of the character speed set by -w (this is the "Farnsworth" thing, iykyk).
• -W x — Extra Word spacing. Similar to -e, but it only affects the inter-word spacing, not the inter-character spacing.
• -f freq — audio frequency in Hz [600]
• -T SINE|0|SAWTOOTH|1|SQUARE|2 — set the waveform to sine, sawtooth, or squarewave. [sine]
• -Q minutes — Increase CW speed (QRQ) by 1 WpM in intervals of minutes. The speed gets reset to the initial value at the start of each chapter. [0]
• -n — Disables resetting the speed when you're using the -Q option.
• -p — Disables the paragraph separator (<BT>)
• -R risetime — risetime, in samples [50]
• -F falltime — falltime, samples [50]
• -O — Use the OGG/Vorbis encoder instead of MP3, if it was compiled with OGG support
• -X — Do not encode, do not generate output files
• -s samplerate — samplerate for the OGG/MP3 file [11025]
• -b bitrate — MP3 bitrate, kbps [16]
• -q quality — MP3 quality, 1 (best) to 9 (worst). CW still sounds very good with the worst quality, and encoding time is greatly reduced. [5]
• -c chapter separator — Split chapters at this string [CHAPTER]. If it's empty or starts with a dash, chapters will not be split and the output files will not be numbered.
• -d duration — Splits output files after "duration" seconds; finishes the current sentence.
• -l wordlimit — Splits output files after "wordlimit" words; finished the current sentence.
• -o outfile-name — Output filename (chapter number and .mp3/.ogg will be appended) [Chapter]
• -a author — Author for the ID3 tag. Use quotes for strings with spaces (e.g. "JW Goethe")
• -t title — Title for the ID3 tag. Use quotes for strings with spaces (e.g. "Faust II")
• -k comment — Comment for the ID3 tag. Use quotes for strings with spaces.
• -y year — Year for the ID3 tag.
• -u — Switches the input encoding format to UTF-8. Currently supported alphabets include Latin, Greek, Hebrew, Arabic and Cyrillic. Default is ISO 8859-1.
• -E file — Loads configuration from file.
• -g file — Guesses the encoding of file (ISO 8859-1 / ASCII or UTF-8).
• -S [ISO|UTF] — Shows a table of all available morse symbols for the ISO 8859-1 and UTF-8 character sets. Output in HTML format.
• -N snr — When this option is used, a noise background is added to the file and the CW signal is scaled down to achieve a SNR (Signal to Noise ratio) of "snr" dB. Possible range of SNR: -10db to 10dB. Make sure to enclose the value in quotation marks if it's negative (i.e. -N "-3").
• -B bandwidth in Hz — Sets the filter bandwidth if the -N / SNR option is used. Available filters are 100Hz, 500Hz, 1kHz and 2.1kHz.
• -C frequency in Hz — Sets the center frequency of the filter if the -N / SNR option is used. This should be set to the frequency of the Morse signal; currently implemented center frequencies: 800Hz

---

✨ TEXT COMMANDS ✨

CW prosigns can be generated by enclosing arbitrary letters in angle brackets (e.g. <AR>, <SK>, ...). 🎀

The tone frequency (f), speed (w), effective speed (e), volume (v, 1..100) waveform (T) and SNR (N) can be changed arbitrarily within the text by inserting commands — starting with a pipe symbol, followed by the parameter to change and the value. On top of that, |Sn adds a period of n milliseconds of silence to the file at the given position (0 < n < 10000). 🤫

Example: |f400 changes the tone frequency to 400Hz, |w60 changes the speed to 60wpm, |T3 changes the waveform to squarewave.

---

✨ CONFIG FILE AND CHARACTER MAPPINGS ✨

ebook2cw looks for a config file, ebook2cw.conf, in which all settings that can be changed by command line parameters can be set. Any settings made in the config file can be overridden by command line arguments. 👑

Additionally, two map files can be set in the config file, for ISO8859-1 and UTF-8. You can map characters in those files to a string, which may be useful to replace characters like the exclamation mark (!) to a period (.), which is more common in CW.

A set of example config and map file and a description thereof can be found at DESTDIR/share/doc/ebook2cw/examples/. 📁

---

✨ MISC ✨

ebook2cw can also be compiled to run as a CGI to serve MP3 and OGG files on the fly for web applications. main character energy fr fr 💅

---

✨ AUTHOR ✨

Fabian Kurz, DJ5CW <fabian@fkurz.net> 🫶

https://fkurz.net/ham/ebook2cw.html

---

✨ SEE ALSO ✨

• morse(1)

---

And that's the whole page, bestie — Linux, APRIL 2021, the ebook2cw(1) manual, done and dusted. No skips, no missing flags, ate. 💖✨🎀🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜