------------------------------------------------------------------------------
 mp3stuff v0.986 by ^Andy@ircnet (updated February 12th 2000 2:47am EST)
------------------------------------------------------------------------------
 this is an addon made for mIRC32 v5.7
 homepage:  http://come.to/andys.site/  or  http://pages.cthome.net/pdufilie/
 send bug reports, comments, and suggestions to: a_s_d@snet.net
------------------------------------------------------------------------------
 to install this addon:
   files needed:  mp3stuff.mrc  and  mp3stuf1.mrc
   move all mp3stuff files to your mIRC directory
   type the following in a mIRC window:  /load -rs mp3stuff.mrc

   when a window pops up asking if you want to
   run initialization commands, click on 'yes'
--------------------------------------------------------------------------------------------

 ||
 |  mp3stuff help  |
 |_________________|
   mp3stuff adds popups to the Status Window, Channel, Query, and Menubar.  mp3stuff will
   work with mp3s that have commas, and even double-spaces in the file names.  mp3stuff
   uses mp3 file info caching.  The first time it gets info from an mp3, it will save the
   info for later use.  This makes everything go much faster.  You can install mp3stuff
   from any directory; just put both .mrc files into the same directory, and include the
   path when you install.
   Example:  Put both .mrc files into c:\mp3\, and type /load -rs c:\mp3\mp3stuff.mrc
             If the directory has a space in it, put quotation marks around the file.
             Example:  /load -rs "c:\m p 3\mp3stuff.mrc"


 ================
  remote control
 ================
   The remote control is a small dialog that you can keep open for easy playing of mp3s.
   To open it, click on this in the popup:  "mp3stuff > open remote control".

     'choose' button
       - Lets you pick an mp3 to open.

     'random' button
       - Opens a random mp3.  If you have the playlist enabled, it will pick
         a random one from the playlist.  If the playlist is disabled, it
         will pick a random one from your mp3 directories.

     continuous play
       - If this box is checked, mp3stuff will play a
         random mp3 after the current one finishes.


 ================
  options dialog
 ================
   In this dialog, you can configure most of the options available in mp3stuff.
   To open it, click on this in the popup:  "mp3stuff > more options > options dialog".

   -----------------------------------------------
    first tab of options dialog (labeled "stuff")
   -----------------------------------------------

     'about' button
       - Opens a dialog that shows the version number, has a button
         to send me an e-mail, and a button to visit my web page.

     mute
       - Allows you to play mp3s to a channel without listening to them yourself.
         This will be disabled when you click on a popup or button to listen to an mp3.

     listen to others' mp3s
       - When others play mp3s and their script sends an mp3 ctcp,
         mp3stuff will search your mp3 directories for the file and
         open it.  If the mute option is on, this will be disabled.

     allow others' to interrupt your mp3s
       - If this and "listen to others' mp3s" are both enabled, mp3s played by others
         will be opened, regardless of whether or not you are currently listening to an
         mp3 with mp3stuff.  If this is disabled, then it will only open mp3s played by
         others if you are not already listening to one with mp3stuff.

     send mp3 ctcps when playing
       - This allows others to hear your mp3s if they have the
         mp3 and they have an mp3 script that uses mp3 ctcps.

     echo your mp3 ctcps when playing
       - Do you want to see the mp3 ctcps that you send?  That's what this option is for.

     show mp3 file info when playing/listening
       - File information includes file size, length, kbps, khz, and mono/stereo.

     show "playing continuously" when doing so
       - Displays "playing continuously" when you play or
         listen to mp3s and you have continuous play on.

     use random border color when playing
       - This will pick a random color to use on brackets when playing to channels.

     echo to status instead of active when listening
       - If you don't want mp3stuff echoing to the active window
         when you are listening to mp3s, then check this box.

     check for new versions on startup
       - When this is enabled, mp3stuff will check if you have the latest version when
         you open mIRC.  You can check for new versions at any time by clicking on the
         "check for new version" button on the third tab of the options dialog.

     install new versions when found
       - When a new version is found, this will download and install it automatically.
         You can have mp3stuff install the newest version at any time by clicking on
         the "install newest version" button on the third tab of the options dialog.

   ----------------------------------------------------------------
    second tab of the options dialog (labeled "file serving/list")
   ----------------------------------------------------------------

     auto-send
       - Allows others to get files from you by typing "!<your nick> <file name>"
         into a channel or query with you.  Also allows others to get your mp3
         list from you by typing "@<your nick>".
         Example:  If your nick is "Bob", and you have an mp3 named "Good Song.mp3",
                   people can type "!Bob Good Song.mp3" to get it from you.  To get
                   your list, people can type "@Bob".

     number of send slots
       - This will limit the total number of sends you can have at the same time.
         If you have the maximum number of sends open, and someone request an mp3
         from you by typing "!<your nick> <file name>", the request will be placed
         in a queue list, and it will be sent when enough files finish sending.

     length of queue list
       - Limits the length of the queue list, as described above.
         If the queue list fills up, no further requests will be recorded.

     display script ad when auto-sending
       - Includes an ad in the notice that is sent when a file is requested.
         The ad contains the script name, the version number, and the website
         where it can be downloaded from.

     @locator/@find
       - People can type "@locator song name" or "@find song name" in a channel or
         query with you, and mp3stuff will send the person messages if it finds any
         matches to their search.  Spaces will be replaced by "*"'s. A "?" will match
         any one character, and a "*" will match zero or more characters.
         Example:  If you have an mp3 named "Good Song.mp3", then all of the following
                   will find it:  "@locator good", "@locator s?ng", "@locator oo ong"

     note to send with [@locator/@find] results
       - If you have specified a note and an mp3 is found by a @locator/@find search,
         the note will be sent with the results.

     use custom dialogs to get mp3s/directories
       - You can use either the custom dialogs, or the default file selecting system.

     'current list' button
       - This will open your current list, if you have made one.

     'update' button
       - This will make a list of your mp3s.  A minimized copy of mIRC will open, and that
         mIRC window will create the list.  It will close when the list is done.  The more
         organized your mp3s are in your directories, the more organized the list will be.

     use full info
       - File information includes file size, length, kbps, khz, and mono/stereo.

     nick used in lists
       - This nick will be the one that is shown with a "!" before each file name in
         the mp3 list.  The list shows "!<your nick> <file name>" for each file, for
         easy requesting.  This nick will also be used in the file name for the list.

   -----------------------------------------------------------------
    third tab of options dialog (labeled "dirs/player/version no.")
   -----------------------------------------------------------------

     mp3 directories
       - The directories you set will be used to find mp3s when making
         mp3 lists, when playing random mp3s, when other people play
         mp3s, and when people use @locator/@find/!nick file commands.
         When a directory is set, all the sub-directories are included.

       'add' button
         - Adds an mp3 directory.

       'rem' button
         - Removes the selected mp3 directories.

     check for new version
       - Click on this button to check if you have the latest version of mp3stuff.

     install newest version
       - Click on this button to download and install the latest version of mp3stuff.

     mp3 player
       - If the default setting does not work for you, then you need to set an mp3 player
         in the third tab of the options dialog.  Winamp is recommended, but not required.
         If a new window opens every time you play an mp3, you need to go to the options
         of the mp3 player and disable that feature.  If you are using Winamp, do this by
         clicking on "options > preferences > options" in Winamp, and make sure the option
         called "Allow multiple instances" is un-checked.

       'set' button
         - Lets you pick an mp3 player.

       'default' button
         - Uses the default setting.


 =================
  playlist editor
 =================
   You can create a playlist and have mp3stuff play random mp3s from it.  To open the
   playlist editor, click on this in the popup:  "mp3stuff > more options > edit playlist".

   --------------------------
    playlist editor controls
   --------------------------

     buttons:

       add file
         - Adds one file.

       add dir
         - Adds all mp3s in a directory.

       add wildcard
         - Adds all mp3s in your mp3 directories that contain a certain string.

       remove selected
         - Removes the selected mp3s.

       remove dir
         - Removes all mp3s in a directory.

       remove wildcard
         - Removes all mp3s that contain a certain string.

       remove dead files
         - Removes all files that no longer exist.

     checkboxes:

       use playlist for getting random mp3s
         - Enables or disables playlist feature.

       only play each mp3 in playlist once
         - Will not repeat mp3s until entire playlist has been played.


 ============
  /mp3search
 ============
   You can type /mp3search <search string> to find mp3s in your mp3 directories.
   /mp3search can also be accessed by clicking on "mp3stuff > more options > /mp3search"
   in the popup.  Wildcards may be used in the search string.  A "?" will match any one
   character, and a "*" will match zero or more characters.  Spaces in the search string
   will be replaced with "*"'s.  When mp3s are found, you can right-click in the mp3 search
   window to get a menu.  Double-clicking on an mp3 listens to it.  You can search again by
   typing in a search string in the editbox at the bottom of the mp3 search window.

     mp3 search right-click menu:

       copy location
         - Copies the path and file name to the clipboard.

       listen to this mp3
         - Listens to the selected mp3.

       listen to one at random
         - This will pick a random mp3 from the mp3 search window and listen to it.

--------------------------------------------------------------------------------------------
