                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                          SMF Media Player v8.5
                        for mIRC v5.71 and higher
                                Help File
                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Homepage    : http://dgsoft.cjb.net
MediaPlayer : http://dgsoft.cjb.net/mplay/


                        NOTE FOR WINDOWS NT USERS:

I don't know anything about Windows NT. i've done my best to make the addon
   as compatible as possible, but i cannot promise it will work perfectly.

-=<Setup>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

After loading the addon using the /load command, Setup will automatically
search for it's second script file (mplay2.mrc). if the file is not found,
it will unload itself. Otherwise, a settings window will open with 7 buttons
and a drop menu which are:

CD Player : Consists of two sections which are:

           CD-ROM Drive: Provides you with a list of CD-ROM drives avaliable
                         on your computer and an "off" option. selecting
                         "off" will disable the CD Player section of the
                         script, anything else will be used as the CD drive.
           Windows Dir : If a drive is selected, opens a window that lets
                         you browse through your hard drive(s) and choose
                         your Windows directory.

MP3 Player: Consists of two sections which are:

            Player : Opens a dialog window with the following options:
                     Winamp : Being the most common player, winamp is the
                              "default" selection (setup searches for
                              "winamp.exe")
                     Other  : Lets you type in the name of your player
                              (automaticly adds .exe if needed).
                     Off    : Tells setup that you do not have an MP3
                              player, and turns the MP3 section off.
                     OK     : Closes the dialog and looks for the selected
                              file (using Mediaplayer's "find")
                     Browse : Opens a window that lets you browse through
                              your hard drive(s) and choose the program file
                              of your MP3 Player.
            Dir    : Opens a window that lets you browse through your
                     hard drives and choose the program file of your MP3
                     Directory.
MIDI Dir : Opens a window that lets you browse through your hard drives and
           choose your MIDI Directory.

WAVE Dir : Opens a window that lets you browse through your hard drives and
           choose your Wave Directory.

-=<Main Menu>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Once opened, searches for missing components (graphics file, variables, etc)
and prompts you if anything is missing, after that, opens a picture window
with a side bar and a side listbox.
The buttons on the left show the active/inactive/disabled parts of
the script, while the buttons on the right allow you to access the script's
options (each button is described in the text strip under the buttons.

-=<CD Player>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Uses the CD Player that comes with Windows 9x/NT and it's data file
(cdplayer.ini). Checks for CD-ROM status every 3 seconds and updates the
main window accordingly. When an audio CD is inserted, makes the buttons
avaliable.

Track Editor       : Once clicked, checks the CD section in the cdplayer.ini
                     and fills all the missing parameters (such as the
                     number of track, play order etc), then opens a dialog
                     box, clicking a track (or selecting it and clicking
                     the "edit" button will open another dialog which will
                     let you change the name for the tracks.
List               : Using the Windows CD Player's database file
                     (cdplayer.ini) which is located in your
                     windows directory, gets the CD's track names.

-=<MP3 Player>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Has six buttons which are:

M3U Editor       : Lets you edit/make M3U
                   playlist files, opens a dialog box with two listboxes
                   (one holds the content of your MP3 directory and the
                   other lists the content of your M3U), 2 buttons and a
                   menu with 7 items which are:
                   New    :Creates a new file
                   Open   :Opens an existing m3u file
                   Import :Imports the selected m3u file into the one being
                           edited
                   Save   :Saves the m3u file
                   Save As:Saves the m3u file under another name
                   Add    :Adds the selected mp3 file(s) from the directory
                           to the m3u listbox
                   Remove :Removes the selected mp3 file(s) from the
                           m3u listbox
                   Clear  :Clears the m3u listbox
                   Exit   :Closes the editor without saving the m3u file
Directory Listing: Lists the content of your current
                   MP3 directory (sub directories included). double click
                   plays the selected file, right click adds selected files
                   to the playlist or plays them.
Directory Manager: Lists your MP3 directories,
                   directories can be added-removed by right clicking the
                   listbox, you set a directory as your current directory by
                   double-clicking it.
Favorites        : lists your favorite songs,
                   files can be added/removed/played by right-clicking the
                   listbox
Play             : Plays a selected file
Stop             : Stops playback

-=<MID Player>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Has nine buttons which are:

Shuffle               : Plays a random file from the list when one ends
                        (requires the loop option to be turned on).
Loop                  : Self-explanatory.
Back                  : Self-explanatory.
Directory Listing     : Lists the content of your current MIDI directory
                        (sub directories included). double click plays the
                        selected file, right click adds selected files to
                        the playlist or plays them.
Directory Manager     : Lists your MIDI directories. directories can be
                        added/removed by right clicking the listbox. you set
                        a directory as your current directory by
                        double-clicking it.
Favorites             : lists your favorite files. files can be
                        added/removed/played by right-clicking the listbox.
Play                  : Self-explanatory.
Stop                  : Self-explanatory.
Forward               : Self-explanatory.

-=<WAV Player>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Same as the MIDI player

-=<Search Engine>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Opens a listbox window, searches your hard drive(s) for parameters (for
example, *.txt) entered in the editbox, media files covered by the media
player (mid, cda, mp3, wav) are being played through the script's internal
defaults while the rest are opened by a program set in the Windows'
preferences.

-=<INI File Guide>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

[settings] : The script's main settings
mplay.bmp= : path of mplay.bmp
winloc=    : location of the main window
winsze=    : main window size
cd.drv=    : CD-ROM drive
mp3.ply=   : MP3 player
dir.mp3=   : MP3 directory
dir.mid=   : MIDI directory
dir.wav=   : Wave directory
windir=    : Windows directory

[mp3.dir]  : List of your MP3 directories

[mid.dir]  : List of your MIDI directories

[wav.dir]  : List of your Wave directories

[mp3.ply]  : MP3 playlist

[mid.ply]  : MIDI playlist

[wav.ply]  : Wave playlist