3. Next the script will ask you 2 easy questions.


• Question 1. Where is your MP3 player? This is the program (probably WinAmp or WinPlay3) that you use to play your MP3s
  
  
• Question 2. Where are your MP3s? Here you tell the script which directories (folders) you keep your MP3s in
  You can set as many different folders (and drives) as you like

That's it! You can now play MP3s to others, or listen to other's MP3s
(they play automatically if you have them).

To play your first MP3...

Right-click in any channel, and choose "Play an MP3" from the menu
A box will pop up with your MP3 directory. Select the MP3 you want to
play and click OK
Hopefully two things will happen: The MP3 starts playing on
your player, and a message and a message like the one below
will be sent to the channel, and anyone else with a compatible
MP3 Script (and the same MP3) will hear it too!

@mp3 queen - bohemian rhapsody.mp3 (4427483 bytes, 128kbps STEREO)

When you're ready for more,
check out the "Autosending files" and "Options" menus

An alternative to using the popup menu for playing MP3s is to
(in mIRC) type /mp3 <word> [word2] [word3]
(word means any part of the filename that you want to play)
You do not have to type the whole filename, for instance "athe"
could be enough for "The Prodigy - Breathe.MP3", and "forg forg"
could be enough for "The Corrs - Forgiven Not Forgotten.mp3".
If you type /mp3 (without anything after it) the script
will play a random MP3.

SUGGESTIONS:
There are a few DCC settings that I suggest you change
if you want to send your songs to other people on IRC.

1. Close DCC send window.
Put a check mark in the "On DCC completion:, Close window, Send" box
This way when you finish sending a file, mIRC will close the send window

2. DCC timeout.
In the same DCC options screen as Close DCC send window.
This is how long mIRC will wait before deciding
that a DCC send has failed
Change this by clicking DCC menu, Options, Options tab.
Set the Send/Get Transfer timeout to around 300 seconds.

3. Filling filename spaces.
By default, when you DCC send a file which
contains spaces in it's name, mIRC will replace the spaces with
underscores, the _ character.
This is because other IRC clients (pIRCh, ViRC, IRCle, BitchX) do not
understand DCC sending filenames with spaces.
You can leave this "filling spaces" option turned on, and be able
to send all files to everyone, or you can turn it off, and preserve
your original filenames.
If you want to turn it off and preserve your filenames, you must start
a DCC send in order to change the setting, and uncheck "fill spaces"
after selecting the file to send.

NOTES:


• The script does a few things without telling you, like sending
  messages to people when they request your MP3s, and when
  they use the @Locator function built into this script.
  
• If your "send slots" (the maximum number of songs you want to send
  at once) are full when someone requests an MP3 from you, the script
  will give them a message like the one below
  
  <-- message goes here -->
  
  You can use the request queueing feature to save extra song
  requests, and the script will send them when a send slot becomes available.
  
  If you do not enable auto-sending of your MP3 list (in the
  Autosending files menu) people requesting your list will receive
  a message like the one below
  
  -Mulva- Sorry, auto-sending of lists is disabled
  
  If you do not enable auto-sending of your MP3s (also in the
  Autosending files menu) people requesting mp3 files will receive a message like the one below
  
  -Mulva- Sorry, autosends are off
  
  The script will detect if someone requests the same song twice, and will send them a message saying that they are already receiving that file, and will tell them that they can stop the send (for example if they got disconnected) by typing
  
  <your nickname> kill sends
  
  Unfortunately it is not possible for a script to stop just one send, so all current sends to that person will stop (if they are getting more than one file at once from you)
  
  
  Upgrading the script:
  
  
  To upgrade this script, simply unzip the new version to your mIRC folder and type
  
  /reload -rs mp3play.mrc
  
  
  Uninstalling the script:
  
  
  If you want to uninstall the script, just type /mp3uninstall
  This will COMPLETELY remove the script from mIRC.
  It will clear all settings, and unload and delete all files belonging to THIS script (it will not affect other scripts if you have any)
  If you want to save any files from the script, move them *BEFORE* uninstalling
  
  
  
  For more information about this script, visit this page
  
  I hope you come and visit us in #MP3_Central on DALnet, and also in our second channel #FreeMusic
  
  NOTE: This script has been banned in #mp3central on DALnet, so it will not function
  while in that channel (to prevent you being banned from there)
  
  Latest changes, newest at top:
  
  
• Send queue menu is now "smart" (will only show available options)
• Script is now just one .mrc file instead of 3
• Add file option bug in send queue has been fixed
• Nick change updating bug in the send queue has been fixed
• MP3 listmaker has been rewritten again, is now roughly 30% faster, also fixes a bug where the list was including file creation dates and times on some computers, should now also work properly on Windows NT (needs testing)
• Playlist maker has been replaced (needs testing)
• "Add file" option re-added to send queue manager (needs testing)
• Even more "idiot-proofing" (user error handling) added
• Grabber bug fixed, kill sends bug fixed
• Script now enabled Fast Send and sets DCC packet size to 4096 when you load it
• Send queue manager program has been replaced by script code
• Send queue now updates itself when someone in it changes their nick (needs testing)
• People whos nicks contain "[[" can now use the send queue (needs testing)
• Listmaker has been completely rewritten, and is now about 30 times faster (needs testing)
• Script menu has mostly been updated to show current settings on the menu itself (has been made "smart")
• Literally hundreds of bug fixes and code optimisations

• Fix continuous play to never play same song twice in a row
• Add option to terminate DCC sends below specified CPS
• Fix <10% bug in Stats, limit stats length/speed ; Add shitlist, add friends list ; Move more settings to Drives.ini
• Finish making entire menu "smart"
• Small bugfixes and code revisions
• Lots of work on this readme file