Go to file
Fabian Kurz 9a4c5ee836 Release 0.8.4 final touches. 2021-04-07 18:48:43 +02:00
po Add German translation 2013-03-02 20:36:30 +00:00
COPYING Initial import of ebook2cw 2008-06-19 18:52:38 +00:00
ChangeLog Fix Farnsworth timing (tnx DM4SG for the patch!) 2021-04-06 21:02:25 +02:00
Makefile Release 0.8.4 2021-04-06 21:02:48 +02:00
README Release 0.8.4 final touches. 2021-04-07 18:48:43 +02:00
codetables.h codetable: also fix lowercase ae (was .- ., now .-.-) 2017-07-15 07:21:14 +00:00
ebook2cw.1 Release 0.8.4 2021-04-06 21:02:48 +02:00
ebook2cw.bat update docs 2011-01-25 20:25:49 +00:00
ebook2cw.c Fix Farnsworth timing (tnx DM4SG for the patch!) 2021-04-06 21:02:25 +02:00
ebook2cw.conf make config file pure ASCII 2011-05-01 13:50:04 +00:00
isomap.txt readconfig, etc. 2008-07-03 13:13:55 +00:00
utf8map.txt readconfig, etc. 2008-07-03 13:13:55 +00:00

README

ebook2cw v0.8.4 - convert ebooks to morse code - Fabian Kurz, DJ1YFK
---------------------------------------------------------------------

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

ebook2cw is a command line program which converts a plain text ebook to morse
code MP3 or OGG files. It works on several platforms, including Windows and
Linux.

It automatically splits and numbers the output files by chapters.

For a detailled description, please refer to the man-page or the project
website.


INSTALL
--------
1) Binaries
Statically compiled binaries are available at the project website, for Linux
(i386) and Win32. Those should be suitable for most users.

2) Source
A Makefile is included; it compiles both under Linux and Windows (with MinGW).
DESTDIR is /usr by default (so the binary will be in /usr/bin/).
Support for LAME and/or OGG can be disabled by USE_LAME=NO and USE_OGG=NO
respectively.

make [DESTDIR=..] [USE_OGG=NO] [USE_LAME=NO]
sudo make install

Build prerequisites (Debian/Ubuntu): build-essential libvorbis-dev libmp3lame-dev

CGI
---
ebook2cw can also be compiled as a CGI, with "make cgi" or "make cgibuffered".
The executable can then be used on a webserver and called in the format

http://example.com/cgi-bin/cw.cgi?s=25&e=25&f=600&t=%20hello%20world

which returns a MP3 file with "hello world" at the given speed etc. The order
of the GET parameters must be used as shown above. Real-world examples of
ebook2cw as a CGI can be found at http://lcwo.net/.

The default cgi version operates "on the fly", the "cgibuffered" option 
first writes the whole MP3/OGG to a temporary file, so it can send a proper
Content-Length: header which may be required for some clients.

Contact
-------
Fabian Kurz, DJ1YFK <fabian@fkurz.net>
https://fkurz.net/ham/ebook2cw.html