KABOOK audiobook mp3 player with bookmark tts indexing and text editor.


 *  KABook 

    k a b o o k     Audiobook mp3 player

with number pad control is optimal for all listeners, audio learners, dyslectic, low vision, and blind. Bookmark links to the mp3 position while listening. Associated text linked to the mp3 is accessible by a large font text editor and espeak text to speech.

* Install


Kabook runs on Linux with the following required packages.
1   expect        extension of tcl (Tool Command Language)
2   tk               extension of tcl (Tool Command Lanugage)
3   aumix         audio mixer is needed to control the volume.
4   mpg321      open source mp3 player
5   espeak       text to speech voice
6   joy2key      only needed if you use the joystick foot pedal option
+ Debian packages:
You may add missing packages to a live DVD KANOTIX KNOPPIX or debian system.
Open a root shell, open this link and copy and paste.
Edit to delete any packages you already have.
+ Installing and Reinstalling
1   Create a working folder and add one mp3 file.
2   Open the folder in a terminal and enter kabook-install
     Alternatively just copy the hidden file .0000 there and enter ./.0000
3   Open a shell and cd into that folder.
4   Enter ./.0000              spoken dot slash dot zero zero zero
5   .f  ENTER ENTER        Do this only if you use a foot pedal.
6   Enter ./.0                    spoken dot slash dot zero

Note that kabook is run from the hidden file .0000

You may need to make this script file executable: chmod 777 .0000

If your command line does not run .0000 try ./.0000 or enter PATH=$PATH:. to place your local folder in the path.

Copy .0000 to install it to a folder on a usb flash drive or floppy.

For a new mp3 erase the visable files, add a new mp3 and run ./.0000

For a new version you must also erase all hidden files.

+ Uninstalling
Simply remove the working folder and files matching /var/tmp/kabook*

* Download

+ Get the latest experimental version.
Create a new folder and open a terminal in that folder.
Copy one mp3 audio file into that directory.
Optionally, also copy an associated text file.
# For example open this link and copy and paste these lines and hit enter:
Open this link. Copy and paste the content into your shell.
Enter ./.0 to play. That is read: dot slash dot zero enter

* Run

+ Running: Working Folder mp3
The simplest use is to have a single mp3 in the working directory.
To initialize the first bookmark enter .0000    Spoken: dot 0 0 0 0
To play enter 0---    Spoken: 0 minus minus minus
+ Running: Different Directory mp3
After .0000 give a bookmark name and then the path to the mp3 file.
For example if a bookmark is made with:
.0000 55 /media/sda1/mybook/chapter1.mp3
55--- will play it but bookmarks are made in the local directory.
+ Restarting Bookmarks
0--- restart with at the initial point in the mp3 file
0-0- restart where period exited while listening
0-04 restart at the point where 4 was pressed when playing
MyMark-0- restart where period exited, here a name is used in place of 0
+ Basic Commands
Read text file 1 as a guide for using kabook.
/ * 1 will open text file 1 to be read.
Only some basic commands are listed here.
You can learn more commands by pressing the period key in any menu.
Menu 4 is to teach the key board and simply reads the key pressed,
but if no key is pressed in a few seconds you are sent to Menu 1.
+ Downloading mp3 files:
Text file 3 is a guide to finding links to mp3 files
on web pages and downloading the mp3 files.
Try the LibriVox link below for audiobooks in many languages.
+ For keyboard differences or no number pad
these alternate keys eliminate shifting:
  us keyboard           = for +    backtick for *
  German keyboard       < for /    # for *
  German number pad     comma for period
  foot pedal            right for +, left for -, center for \

* Sample Screens

Warning:  General ideas are shown here but the current release may differ greatly.
Sample Text Screens
The follow link gives visual charts of kabook menus and states.
Visual Diagram of Kabook

* News

+ 3 Mar 2010 Added ./.0 345 to start playing a frame 345.
+ 1 Jun 2009 Transcription of mp3 dictation with a foot pedal. (vPedal tested)
Transcribe in a window while controlling back, forward, play, pause and volume.
+ 1 May 2009 MANOTE audible music notation allows reading of a
music score by listening. MANOTE http://manote.sourceforge.net
+ 15 Apr 2009 Use Google to translate text in file 7 into file 8.
  Target language is selected by the DEL key,
+ 15 Mar 2009 Improved getting podcast and mp3 files from the internet.
  Help and demonstrations are in file 3.
+ 12 Mar 2009 Espeak language selection is saved with the DEL key
  so that kabook starts reading with the voice of that language.

* Mission

+ A player for audiobooks allowing resume and multiple bookmarking.
+ Searchable text associated with links to mp3 file positions.
+ Audio and text materials usable for efficient study, teaching and sharing.
+ Easy use for general users, audio learners, dyslectic, and visually impaired.
+ Open source alternatives to accessibility enhanced electronic media.
+ Block text editor that manipulates text without seeing the target screen.
+ Inexpensive screenless speech and non keyboard controlled Linux desktop.

* Use

+ Audiobook, Podcast, Lecture notes, School textbook, Music study.
+ Facilitation for low vision, dyslexic and under motivated readers.
+ Provide indexes, web links, explanations, glossaries, and quizzes.
+ Educator presenting mp3 segments with links to images and text.
+ Foreign language learning with repetition and linked language text.
+ Transcription of mp3 files with foot pedal controlle.

* Old News

07May2006  Podcast web mp3 files are listed, downloaded and played.
Mar2006  clipboard may be read aloud by placed it in a text file
11Feb2006  podcast aggregator allows storing and streaming podcasts
29Nov2005  search function for text files, flac player tested.
10Mar2005  festival reads files associated with the mp3 file.
15Oct2004  .kabook shell mode is fully controllable by the number pad.
13Aug2004   After 1 year project is GNU General Public License (GPL)copyright.

* Author and Links

David M.
  Tan Creti

IRC nick paradocs
Public key:

Other Projects:

Optimized layout
for the blind
with ELinks and screen readers.


Web Pages and KAbook Texts
are licensed (CC)
Creative Commons

Creative Commons License

Thank You for Being
Part of
Open Source Software

Support This Project

KABook ©
GNU Copyleft


of books
in the
public domain

LibriVox public domain audiobooks

Hosting courtesy of