
     CDplayer 0.1 (C) 1993 DataSoft Communications
     ---------------------------------------------

1. License and Modifications

This program is distributed under the GNU public license. You can
modify it and re-distributed as you wish, but the source must be
supplied. 

If you do make changes, please mail me a copy of the changes at
mark@datasoft.north.net so I can add it to the program in a future
release.

2. Introduction

After installing my Mitsumi CDROM and the Linux mcd 0.3 driver, I
wanted to be able to play audio CD's. To my dismay, the only player
was for X-Windows, which is something I don't use. One evening, I got
fed up and decided to write my own non-X version. After review the
xcdplayer source, the mcd source, and the cdrom.h header file I was
able to figure it out. This is the first release.

3. What is it?

CDplayer is a silly little utility to play audio CD's in a CDROM
drive attached to Linux. Currently, it is command line oriented, but
this will change. IT DOES NOT REQUIRE X-WINDOWS! Currently, it allows
CD's to play, to play starting from a track, to be stopped, and to be
paused. The program is run, the command processed, and the program
exited.

4. Compiling and Installing.

Frankly, this program is simple and you should not have to do anything
besides typing make. 

- to compile, type 'make'
- to install, type 'make install'
- to clean up, type 'make clean'

make install, sets the program to be usable by the person who compiled
it. Compiling it as root is a good idea as no one should be permitted
to run the program remotely. (Change this however you want).

5. Using it.

Type:
cdplayer		- shows options
cdplayer play		- play entire CD
cdplayer play 4		- play entire CD starting from track 4
cdplayer info		- display lots of useless information
cdplayer pause		- pause CD, and wait for enter to be pressed
			  to continue play

6. Compatibility.

Well, it works on my system. I use a Mitsumi CDROM with the 16 bit
interface card. My kernel is 0.99.10 and the mcd driver is 0.3. The
ioctl calls are generic so this SHOULD work with any CDROM setup,
though I make no guarranties. If you find this works with your CDROM,
let me know so I can add it to the list of known working CDROM setups.

7. Future

For the moment, this program re-defines the word LAME. But it works.
In the future, possibly in the next release if time permits, I'll make
this use the ncurses library for a full screen implementation that
looks like the xcdplayer with the buttons, timer, etc.. This is my
goal anyways. A random track player is also in my thought banks.

8. Contacting the Author

You can contact me, Mark Buckaway, at:

Email: mark@datasoft.north.net (or mark@accesspt.north.net)
Voice: +1 416 756 4497
Smail: DataSoft Communications
       62 Rock Fernway
       Willowdale, ON
       M2J 4N5
       CANADA

