Go to file
Fabian Kurz f07aeef314 0.8.3 final 2020-05-23 16:24:12 +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 0.8.3 final 2020-05-23 16:24:12 +02:00
Makefile Cosmetics towards 0.8.3 release 2020-04-15 11:20:38 +02:00
README Cosmetics towards 0.8.3 release 2020-04-15 11:20:38 +02:00
codetables.h codetable: also fix lowercase ae (was .- ., now .-.-) 2017-07-15 07:21:14 +00:00
ebook2cw.1 0.8.3 final 2020-05-23 16:24:12 +02:00
ebook2cw.bat update docs 2011-01-25 20:25:49 +00:00
ebook2cw.c 0.8.3 final 2020-05-23 16:24:12 +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
md5sums-bin.txt website 2011-01-25 22:01:44 +00:00
utf8map.txt readconfig, etc. 2008-07-03 13:13:55 +00:00

README

ebook2cw v0.8.3 - 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