File: README

package info (click to toggle)
ebook2cw 0.8.3-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 256 kB
  • sloc: ansic: 1,979; makefile: 64
file content (52 lines) | stat: -rw-r--r-- 1,795 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
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