Daisy-player - A parser to play Daisy CD's with Linux
(C)2003-2010 J. Lemmens

DESCRIPTION
Daisy-player reads a DAISY-CD and plays its audio-files.

REQUIREMENTS
Daisy-player requires madplay, an MPEG Audio Decoder. Be sure
madplay is installed on your system.
Furthermore, be sure the following extra libraries exist on your system:

   libncurses5
   libiso9660-7
   libcdio10

FILES
Download and unpack the file 'daisy-player-<version>.tar.bz2'.
In the created directory 'daisy-player-<version>' you'll find the
following files:

- COPYING: copyright information.
- daisy-player: the binary, i.e. the program
- daisy-player.1: formatted manual page
- daisy-player.c: source code
- daisy-player.rules: rules for udev
- daisy-player.sh: script for udev
       These two files force mounting of the Daisy-CD
- License: The text of the GPL version 3 license of daisy-player
- Makefile: needed to compile from source
- Readme: the text you are reading now.
- TODO: things to do.

INSTALLATION
As user 'root' on the command line, copy the binary file
'daisy-player' into your /usr/local/bin/ directory:

   # cp daisy-player /usr/local/bin/

Copy 'daisy-player.rules' into /etc/udev/rules.d/:

   # cp daisy-player.rules /etc/udev/rules.d/

And copy 'daisy-player.sh' into /lib/udev/:

   # cp daisy-player.sh /lib/udev/

USAGE
As a mortal user, put a DAISY-cd in your cd-player and,
on the command line, give:

   $ daisy-player

This starts reading the DAISY-CD and printing the content on
the screen. After giving an [ENTER], playing the audio files starts.

One could also give a directory with a daisy    
structure as argument to daisy-player:

   $ daisy-player /home/jos/daisy_dir

A list of items on the DAISY-CD will appear. Press <ENTER>
to start playing. When reading of an item has finished, daisy-player will
play the next item and the cursor will automatically skip
to that item, so that your braille-terminal will display the name
of that item.

For keyboard navigation, plese press 'h' or '?'.

Enjoy

Jos Lemmens
jos@jlemmens.nl
http://www.jlemmens.nl
