Cmp3 - Console mp3 frontend

Version 1.5 is a small bugfix release. I am currently working on revamping
cmp3 to work better, it is dirty. This fixes some pause problems and
playlist problems.

INSTALLING -
Make sure you have mpg123 installed somewhere and make sure that the
makefile knows where you have it.
Most common problems arise with ncurses being somewhere other than where it
is on my machine. (or not on at all) If you get LOTS of errors, check to
make sure that you have *n*curses in /usr/include/ncurses/curses.h
Check my web page for other problems that may come up later.

RUNNING -
Type "make" to compile and "make install" to copy it over to /usr/local/bin 
if you want. It may be necessary to edit the Makefile first just to make sure 
everything is set correctly.
With the addition of playlist saving, you can pass in your .ass file as the
first (and only) parameter. Cmp3 will initialize this playlist, then close.
(assuming you don't want to edit a saved playlist, you can reopen it and
edit the list)
There are command line options for managing cmp3. Type cmp3 -h or anything 
that would be invalid and a string of options will be printed. They are
self explanatory.

**************************************************************************
**** List of Keys! There is NO help within cmp3, definately read this ****
**************************************************************************

q - Quit Cmp3 (Outside List Mode)
l - Enter List Mode (see below)
Tab or Left/Right - Switch to Directory/mp3 list
Up/Down - Scroll
PgUp/PgDwn - Scroll FAST!
d - add entire current directory to playlist (must be in directory)
c - clear entire playlist (minus the song playing currently)
+ - Increase the volume ( = works too)
- - Decrease the voume  (that is a minus sign)
k - kill current song 
p - pause song (unpause when next key is hit)
r - refresh screen (Reread the directory and clean screen if something else
    threw something into that tty)
s - The greatest function ever! Suspend the interface, the playlist will
    continue playing until it's all over and you get your console back. 
    If you restart cmp3 while the playlist is going, it will find your 
    old playlist and you can keep editing it.
w - write playlist to file, currently it will write to playlist.ass in
    whatever directory you are currently in (where you started cmp3 from)
	If you have specified an ass repository, then it will go into that
	directory
	View any generated ass file for available options.
Delete - remove file from system, does no permission checking... if it
    didn't delete... you can't delete it (be careful)
h - go back to home directory (where cmp3 was initialized)
a - (only when an ass repository is defined in makefile) switches to ass
	directory and lets you select available ass files

In List Mode -
q - Quit List Mode
Up/Down - Scroll
Delete - Remove file from list
g - grab/let go of a file, use this to move around a file (Up/Down)
(PgUp/PgDwn won't work because I didn't feel the need for it, can be added
    very easily, if you think it's a good idea... let me know)

Contacting me -
If you have any questions/comments/problems with this program, please
email me at 

pandama@psu.edu 

and let me know what you think of it and give me some ideas. 
I also want to know if this is a program worth developing. I know most
people use X-windows and are quite happy with some of the players and
frontends out there, but I like using programs in console and I thought it
was worth it to write this. Talk with me on efnet (IRC) if you have any
problems or comments, my nickname is always pandama.
Check back often to 

http://nkk104.rh.psu.edu/cmp3/ 

I am working on this program until I'm happy with it, and it's a little
way from there. 


NOTES -
I promise to add some helpful output to the screen about what is currently
going on. I've been lazy because I can listen and tell if something's
playing or not. Pause notice will be added very shortly! Sorry.

If something is broken when you try and run/compile cmp3 on your linux
system, first check my web page to see if I have listed anything about it so
far, if I don't know about it, please write me a quick message.
If you try to compile this on another type of unix system and it doesn't
work, don't be surprised. I'm told that the scandir command I use to list
all files is not totally portable. I might take the trouble to define system
types to use opendir and such to fix this, but I am limited in resources and
knowledge. I see no need to add it unless there are some people that need
it. Contact me.

If you modify this program to do something extra or to fix some bug you have
found, email me and let me know what you wanted to add or what was
wrong. This is now a requirement of the license as of version 1.5+.

Thanks to Michael Hipp and Oliver Fromme for developing the best damn mp3
player out today. mpg123 is truly a masterpiece.

Thanks VERY much to Jeff Drost (still zippo?) who helped me with this, 
expecially the shared memory stuff. I feel this is the strongest feature
of cmp3.

# EOF