All My MP3s v1.31
-----------------

copyright by Alex Tonello (January 29, 2000)
atonello@home.com
http://atonello.tripod.com

Other credits:
ID3 Tag functions: Rok Krulec (Rok@fpp.edu)
Winamp (tm) interface functions: Brendin J. Emslie (emslie@gpu.srv.ualberta.ca)
File Info functions: Tric (tricichen@gmx.de)

All My MP3s is a freeware mp3 organizer for hardcore users who have
100s or 1000s of mp3s spread over several harddrives and/or networked
computers. It organizes your mp3s by artist, so you can quickly get
to any song you want and don't have to go searching for it. You can
also easily select any artists or songs and create a playlist on-the-fly.
There is ID3 tag editing and Winamp (tm) control built right in.
The program will also save its settings and window position/size, so when
you load it up, it will be just as you left it.

changes from 1.3 to 1.31:
-fixes the non-working ID3 saving/removing bug
-underscores automatically changed to spaces


Instructions:

Stick the program (and this text file) in its own directory because it's
going to throw a lot of (small) files in there. Then put a nice shortcut
to it on your desktop. To put all your MP3s in the "database", just select
each drive that you have MP3s in, and click the Add by Drive button
(but read the stuff below first).


Filename Formats
----------------

This is crucial to the Adding function. Make sure all files in the
drive/directory you are adding are of one of the checked formats.
Otherwise, each file that I can't determine the artist from will be
put in the "! Unknown Artist !" section. You can also specify a custom
format, where the artist/song separator can be any string. Note that any
formats of yours that have underscores as part of the separators (eg.
"_-_" instead of just "-") will still work, as underscores are stripped.
Also, if you have songs of the format "Artist - Track - Song", just use
the "Artist - Song" format (the track will be part of the song name).
If you use the "Track - Artist - Song" format, the track will be appended
to the beginning of the song name, so you still know what track it is and
so it looks the same as the files that are "Artist - Track - Song".


Main Menu
---------

File - Calculate Total Number of MP3s: counts number of MP3s in database
File - Purge MP3 Database: deletes database if you want to "start fresh"
File - Only Show in Tray: only shows the program icon in the system tray
File - Exit: does just that

Help - Help: loads this text file
Help - About: small about box


Artist Pop-up menu (right click)
------------------

Clean Non-Existing Song:
  This will delete files from the database that no longer physically exist
  for the selected artist.

Delete Artist From List:
  Deletes the selected artist from the database. Pressing the Del key will
  also invoke this.


Song Pop-up menu (right click)
----------------

Add Song(s) to Winamp:
  If Winamp is running, this will add the selected song(s) to the current Winamp
  playlist. Also invoked by pressing F1.

Rename Song Filename:
  Used to physically rename the MP3 file (useful for renaming songs in
  the Unknown Artist section). When a song is renamed, it is automatically
  put under the correct artist if the artist field changed. Hitting F2 also
  loads the rename song box.

Delete Song From List:
  Deletes that song from the database. Also invoked by pressing the Del key.


Buttons
-------

Play Selected Songs:
  This will put all of the selected songs into a playlist and load that
  playlist with whatever MP3 player is associated with it.

Play Selected Artists:
  This will put all of the song from the selected artists into a playlist
  and load that playlist with whatever MP3 player is associated with it.

Find Song:
  Searches all artists for a song containing the phrase in the text box to the
  right of this button. Searching begins with the currently selected artist, and
  wraps to the beginning if it reaches the end. If you hit Find again, it acts
  as a "find next". Hitting F3 when in the find text box also invokes "find next".

Add by Drive:
  Gets MP3 files from the selected drive and sticks them into the database.

Add by Directory (top):
  This is useful if you say downloaded 3 new MP3s (and named them to your
  naming format of course), but don't want to spend the possible many seconds
  to refresh that entire hard drive. Just type the directory path where those
  new MP3s are, and hit the button.

Add by Directory (bottom):
  Same as the previous button, but uses the directory in the directory list
  box as the directory to get MP3s from (remember, you have to double-click on a
  directory to go to it, not just select it).


Winamp Interface
----------------

If Winamp is running, those buttons act as if you pressed them right on Winamp.
That bar is the song position bar.


ID3 Tag
-------

When you click on a file, it'll show the ID3 tag info in the appropriate text
boxes if the info is available. You can change the info in the boxes and hit
Save if you want to change the ID3 tag. Clicking Remove will remove the ID3 tag.
Note: if you get an error loading/saving an ID3 tag, it's probably because you
don't have write permissions on that file.


Other Stuff
-----------

Random Tracks checkbox:
  If is is selected, then when tracks are added to a playlist (if you are
  playing more then one song) then they will be added in random order.

The checkbox beside the volume controls:
  If this is checked, then the left/right volumes move together.

Double-clicking:
  In the artist list or song list plays that artist/song.

Recurse Sub-Directories:
  Used by Add by Drive/Directory. If checked, the adder will recursively
  go into all sub-directories looking for MP3s (recommended).

Hitting Enter:
  When in the Artist list will invoke the Play Selected Artists button,
  and when in the Songs list will play the selected song(s).
