mp3menu Copyright (C) 1997  Rich Condon


Standard Disclaimer Stuff:
-----------------------------------------------------------------

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

You may contact me at        mp3menu@darklight.com
but don't necessairly except a reply - I'm extremely busy.



Informational Type Stuff:
-----------------------------------------------------------------

Basically what this is...is a quick program to load a set of 
mp3's from a directory into a list for you to select from, and 
then play.  I've got a rather large collection of them going and
hate having to do things like play one file at a time.. true i could
just do something like

find dirname -exec mp3play {} \; 

but then I would be forced to listen to everything in that dir...
so this is a good solution... right now this is VERY simple, but I plan
to add more stuff later [see below under TODO]

mp3menu can be invoked with or without a command line option, such that:

mp3menu

will load up the current directory listing of *mp3, or you can do

mp3menu dirname1 dirname2 dirname3

and it will load up everything in those directories...

Current side note: if you do mp3menu *  it will load up all the mp3s one
subdirectory below it. 

Command Summary:
H		Help Screen
R		Toggles Random Ordering
C		Toggles Continuous Play
Y		Toggles all files to YES
N		Toggles all files to NO
O               Does Reordering
UP  or  DOWN    Moves up and down the current play list
PGUP or PGDW    Jumps up or down 1 page
P  or  ENTER	Plays Current List
L		Loads Current Playlist
S		Saves Current Playlist
Q		Quits


Other stuff
-----------------------------------------------------------------

When loading and saving, you have a 35 character limit for file names
live with it.

By default, mp3menu will save lists in your home directory, under .mp3menu.
However, if you'd like it to save to somewhere else, edit mp3menu.h and
uncomment the LISTDIR define, and put that directory in there.  Yippe!

For all you coders out there who will laugh at the way I read in the
directory listing: too bad --> I didn't off hand know how to do the dirent
stuff and I don't have the time to kludge through the .h files to figure 
out how... if someone would like to give me some pointers on this, or 
would like to do it for me... please e-mail at update@darklight.com
(gotta love owning your own domain :))

You can change the colors of the stuff by editing the .h file and
modifying the defines..

You can change the default player by editing the .h file and changing 
it :)  (I thought this would be fairly obvious but some ppl didnt get it)
I recommend getting splay..its small and fast for what it does..sounds good
too

You can #define or #undef the RESET flag, to toggle calling the system
command "reset" after this is over with... some people reported problems
with their terminals being completely screwed over afterwards.. i didnt
have this problem on any of the systems i tested it with, so im not sure
exactly whats going on... this seems to fix it though..


Other Other stuff
-----------------------------------------------------------------
Do whatever you want with this, but if you have a heart attack, your
wife/husband leaves you, your dog bites off a limb -- whatever... 
its not my problem

flame mail can be sent to null@darklight.com

and so on and so forth... 



