# Lines beginning with the pound sign describe the following screen.


# Create and cd into a directory.   Use wget to download the tar file.

knoppix@0[knoppix]$ mkdir myaudiobook
knoppix@0[knoppix]$ cd myaudiobook
knoppix@0[myaudiobook]$ wget http://kabook.sourceforge.net/kabook-1.03.tar.gz

# Unpack the files. Copy one mp3 file into this directory.

knoppix@0[myaudiobook]$ tar -xvvpzf *.tar.gz

# Period 0000 makes the first bookmark.   Enter 0--- to play.

knoppix@0[myaudiobook]$ .0000
     Welcome To KABook Audiobook Controller
   Do Not use names or directories with spaces
The mp3 files are:
Siddhartha.mp3
Creating a bookmark for:
Siddhartha.mp3
To play enter:  ./0---  or 0---
knoppix@0[myaudiobook]$ 0---

# You hear the mp3.   The frame and time change.

---PLAY------K-A-B-O-O-K----K-A-u-d-i-o-B-o-o-k---
Siddhartha.mp3
./0--- Base=0 Tens=0 Jump=100
  TTS=y VERBOSE=n LANG=en
---KEY-------------FUNCTIONS----------------------
    /       pause      pause menu       /  unpause
    .       quit bookmark  0-0-
  1 - 0     bookmark       0-0#
  +   -     jump ahead  jump back
    *       GoTo  Execute      ACTION    TEXT LINE
--ACTION-----------TEXT--LINE---------------------
0
Frame#     3 [662960], Time: 00:00.07 [288:38.15],

# After one minute    /    has been hit to pause play.

--------------------------------------------------
  PAUSE MENU                        / RESUME PLAY
 --------------------------------------------------
     /     Unpause   restart playing
     *     Forward to next menu
   +   -   increase  decrease  mp3 Volume
   0   9   Set the jump interval
     .     Read introduction   and   Help Menu

 ACTION              TEXT LINE
 -------------------------------------------------
  2352 [660611], Time: 01:01.44 [287:36.7

# While paused period or comma speaks the frame number.

--------------------------------------------------
  HELP MENU                        / RESUME PLAY
 --------------------------------------------------
     .     Current frame
     0 - 9 More Help
 --------------------------------------------------

(SayText "2352 Frames. . . . . . .
")

# Key / resumed play.  + + + moved ahead while playing.

---PLAY------K-A-B-O-O-K----K-A-u-d-i-o-B-o-o-k---
Siddhartha.mp3
./0-0- Base=0 Tens=0 Jump=100
  TTS=y VERBOSE=n LANG=en
---KEY-------------FUNCTIONS----------------------
    /       pause      pause menu       /  unpause
    .       quit bookmark  0-0-
  1 - 0     bookmark       0-0#
  +   -     jump ahead  jump back
    *       GoTo  Execute      ACTION    TEXT LINE
--ACTION-----------TEXT--LINE---------------------
2352
j 5516      You may hit enter to correct the screen.
j 5627      You may hit enter to correct the screen.
j 5736      You may hit enter to correct the screen.
Frame#  5759 [657204], Time: 02:30.43 [286:07.79],

# Keys / * Paused and Menu1.    Festival speaks Menu 1.

--------------------------------------------------
 26191 [636772], Time: 11:24.17 [277:14.0
 --------------------------------------------------
     MENU 1                          / RESUME PLAY
 --------------------------------------------------
  .    Read help
  /    unpause   resume play
 + -   increase decrease TTS volume
 0-9    View Text File 0 - 9   Specaial Files are:
 9  overwitten by the latest search results
 *     Forward to Menu 2
(SayText "menu one")

# Key 0 was hit.    Text mode shows lines 1 to 10 of file 0

--------------------------------------------------
 LINES 1 to 10 FILE=0
 / Menu 1  // Play  * Goto S=26191
 1-0  Read line     . Help
 + -  10 Ahead Back   ENTER refresh   SPACE line 1
  s   enter a search   S view search in file 9
 --------------------------------------------------
WELCOME to Kabook . . . . an audiobook controler
of both mp3 and f l a c audio files.
Copyright 2004 David Marc Tan Creti
G N U   OpenSource License www.gnu.org/copyleft
Let's learn about KA-Links . audiobook links jump
within and between text files and audio files.
A link line will begin with ///
After the line has been selected with 1 to 0
you may go to that link with the * key.
Now hit the + to see the next 10 lines.
 --------------------------------------------------                                                          

# Key + advanced to 11 to 20.    Key 5 speaks line 5.

 --------------------------------------------------
 LINES 11 to 20 FILE=0
 / Menu 1  // Play  * Goto S=///
 1-0  Read line     . Help
 + -  10 Ahead Back   ENTER refresh   SPACE line 1
  s   enter a search   S view search in file 9
 --------------------------------------------------
Table of Contents . . . . KA-Links for File 0
/// 0 1   Welcome to Kabook
/// 0 11  Table of Contents
/// 0 31  Basic play control keys
/// 0 51  Navagating kabook text files
/// 0 71  Festival Volume
/// 0 81  Festival Save Volume Offset
/// 0 91  Jump to an audio point in the play file
/// 0 101 Jump to text in an Auto Seek Index
/// 0 121 Jump to a new KABook bookmark
 --------------------------------------------------
(SayText "/// 0 51  Navagating kabook text files")

# Line 5 was a text link.   Key * jumped to that location.

--------------------------------------------------
 LINES 51 to 60 FILE=0
 / Menu 1  // Play  * Goto S=26191
 1-0  Read line     . Help
 + -  10 Ahead Back   ENTER refresh   SPACE line 1
  s   enter a search   S view search in file 9
 --------------------------------------------------
Navagating kabook text files.
Leaving play with / * and then pick a
text file 1 to 0.  File 9 is reserved
for search results and is overwritten.
The standard kabook text file is view in fixed
pages of ten lines.  The prefered line length is
50 characters. You jump by ten line with the plus
and minus keys. Hit the period or comma to to get
current file and line information.
Hit keys 1 to 0 to hear these ten lines.
 --------------------------------------------------
                                                                

# Key \ go to Menu1,    key 1 to text 1,    9 select line 9

--------------------------------------------------
 LINES 1 to 10 FILE=1
 / Menu 1  // Play  * Goto S=26191
 1-0  Read line     . Help
 + -  10 Ahead Back   ENTER refresh   SPACE line 1
  s   enter a search   S view search in file 9
 --------------------------------------------------
Table Of Contents
Book Name  Demonstrationr
Author                    Copyright
If the first word on a line is a nmuber, it is
an mp3 frame number. Select a line with 0 to 9.
Then * will play at that frame number.
0     Introduction
100    Contents
1555    Chapter 1
2990    Chapter 2
 --------------------------------------------------
 (SayText "1555    Chapter 1")
                                                                   

# Key    *    has started playing at frame 1555

---PLAY------K-A-B-O-O-K----K-A-u-d-i-o-B-o-o-k---
Siddhartha.mp3
./0--- Base=0 Tens=_ Jump=100
  TTS=y VERBOSE=n LANG=en
---KEY-------------FUNCTIONS----------------------
    /       pause      pause menu       /  unpause
    .       quit bookmark  0-_-
  1 - 0     bookmark       0-_#
  +   -     jump ahead  jump back
    *       GoTo  Execute      ACTION    TEXT LINE
--ACTION-----------TEXT--LINE---------------------
1555
Frame#  1585 [661378], Time: 00:41.40 [287:56.82],

# At frame 4075   / * 5   has gone to auto seek file 5

--------------------------------------------------
 LINES 11 to 20 FILE=5
 / Menu 1  // Play  * Goto S=4075
 1-0  Read line     . Help
 + -  10 Ahead Back   ENTER refresh   SPACE line 1
  s   enter a search   S view search in file 9
 --------------------------------------------------
03500 This information is on page 2
 Data between 3500 and 4499 is
 found here.







 --------------------------------------------------
(SayText "Reference line 11")
                                            

# The best way to learn is by trying.    More examples later.


#


#


#


#


#