      ====================================
      #                                  #
      #   SpR Juke Box v8.31 by SpinoC   #
      #                                  #
      ====================================

      http://www.spr.wildstar.net 
      http://spr.hurricaneweb.com

******************************************************************************************

      Script Description:

        MP3 and Other Multi-Media File Play/Serving Scripts

      Requirement:

        mIRC 32bit v5.51 or higher
        Winamp v1.91-spl or Higher. Nad is also compatible.
        But, winplay or sonique are not really recommended. 

      Credit

        nMP3 v2.97 by NipKick.
        To get the code for fileinfo such as bitrate samplerate quality Id3tag, I took
        some of his code and modified it.
        Frankly speaking, I dont have an ability to get these infos correctly yet. 
        But, as soon as I get my own way, I will replace it.


      Thanks

        Special thanks to `24ktau, StarsZ, Johnny` and Other ops in #mp3chat
        They opened the official website of SpR Jukebox that I did not even ask.
        The nicest ppl in the world! I am sure!!!!

        Special thanks to I-c-e-man! :) 
        He helped me to even start this script. 
        He also did by suggesting what to improve.
        You can find him in #mp3heaven.
        I really want to thank him :)

        Special thanks to `24ktAu :)
        She helped me by suggesting what to improve 
        and helping people with SpR
        You can find her in #mp3chat in undernet. 
        I really want to thank her :)

        Special thanks to Rage_for_Order
        He helped a lot of ppl on dalnet with SpR.
        He even wrote a FAQ for SpR
        You can find him in #mp3_for_free in dalnet. 
        I really want to thank him :)

        Special thanks to TuneTime
        He helped me solve "target changte too fast" error on undernet version server.
        You can find him in #mp3chat #mp3oldies. 
        I really want to thank him :)

        Special thanks to Rat-a-Tat aka `X`
        He handles most of the spr emails from all over the world, which is an enormous 
        amount of work. You can find him in #mp3chat. 
        I really want to thank him. :)

****************************************************************************************

     [how to setup]

        if you are using **** mirc5.6 **** or higer, please alt+o in your mirc and go to 
        general -> lock and uncheck /run lock.

        To set it up, just move all of the files to your mirc main folder.
        And then, run mirc and type "/load -rs spr-jb1.ini"

        After setup, click on anyone's nick in channel window and right click.
        There is Jukebox at bottom. Go to Jukebox -> Setup -> 1-touch, and click
        1 touch. If you see your random play msg not change randomly, 
        go to setup -> chan setup -> reset chans.

        That's it!

     [how to upgrade]

        It is very important for you to unload the previous version 
        before you overwrite with the new version!!!

        If you already have previous versions of this script, 
        first goto MP3 popup in nickname list, and then click 'unload'. 
        After unloading, unzip spr zip file to your main mirc directory 
        (not spr dir) as overwrite. And then type "/load -rs spr-jb1.ini"

*****************************************************************************************

[what's new in v8.31]
1. A bug fix for getright. Some of ppl may have experienced that getright stops downloading on rare occasions. Fixed.
2. I decided to restore the strategy 1 and 2 for getright. But their contents are different. 
   
   Strategy 1: It requests the 2nd file as soon as you are getting the 1st file, and you get into que early.
   Strategy 2: It, on the contrary, waits for the 1st file to be completed before it requests the 2nd. 
   Strategy 2 is only good when server allows 2 slots per user and you are getting big files so that you need to concentrate on one file to overcome the cps limit for larger file (like mpg). 
   Generally speaking, strategy 1 is much more efficient. 

3. A bug fix for iedit.skn. The playtime, if you put &time& right after ctrl+k+number, is misrepresented. Fixed.
4. Top download chart was mirc intensive if you set the number of songs to a larget number (like 150 top downloads). Some large servers had some trouble with updating their download hitchart.
   Now it will update with another mirc open just like the regular list update. So there is practically no limit to the number now.

[what's new in v8.3]
1. Improved Getright! 

   The weakest point in the former getright is: 
    If you choose strategy 1, it won't request the 2nd file or get into que with it until you finish the first file; as a result, if the target server is busy (i.e., if it doesn't always have an empty slot), your download is slowed down, meaning you have to wait in que until another empty slot is ready.
    If you choose strategy 2, there will be some incomplete files. This was the reason why it was not recommended.

   Now I have put the two together in the way that it will send the 2nd request as soon as you start to get the first file (so either you get into que quickly or start downloading the 2nd file if the server allows you to); however, there will be no incomplete files.
   It will also try to avoid to send redundent requests. In any case, this getright is smater than ever; it simulates the way you think! As a result, it speeds up your downloads enormously because it shortens the time period between the downloads of files.

2. Also I got rid of the dcc protection for getright. It will automatically receive the files from the target server and will handle others according to the default mirc setting. 
   This means there is *** no /tgdcc anymore *** And you can get any files from anyone while you are in getright session without typing /tgdcc.

3. You can set the script to auto ban users from your server if they violate low cps limit 3 times in 1hr. It will warn for the 1st and 2nd time.
   The ban can be removed by the following 3 things. 1) the user reconnect to isp, NOT irc. 2) you reboot your mirc. 3) You manually remove the ban from channel popup -> jukebox -> server ctrl -> access ctrl
   In order to prevent the servers from abusing this ban, I made a maximum limit (2000 cps) for low cps limit for smaller files. (this actually makes a sense cuz the cps limit for larger files cannot come below 2000)
   *** This rule only applies to low cps limit for smaller files.

4. A few typos fixed.

[what's new in v8.211]
0. Got rid of the space limit for list/slot and cd part in list/slot ads setup dialog (but you should be careful because if msg is too long the server will cut it off)
(Sorry for quick upgrade, but this one will last, say, for a few months. So dont be so upset :) 

[what's new in v8.21]
0. Bug fix. Sorry

[what's new in v8.2]
1. Playlist: You can "-file" many files from playlist at once
2. Popup in Channel: rearranged the tools and the server ctrl
3. Display setup: when you put something numeric right after ctrl+k, it misrepresented the item. Fixed
4. List/Slot Ads: Completely Customizable! Got rid of 3 and 5 lines 
5. CD List Ads: will display cds on line if you set up &cdonline& in List/Slot Ads Setup Dialog
6. Multi-Media Setup: Will now differentiate output to mp3 mp2 mpg mpeg (it used to be treated as one in .mp?) This is necessary because there are ppl who serve .mpg yet they don't want to run the file with winamp.

[what's new in v8.1]
1. bug fix: filename editor left an empty sprtmp dir if you use "replace" feature. Fixed
2. Now spr has auto start "on blast" as well as "on mute". If you choose "on blast", spr will start play songs on join of main chan. However, you have to remember that if you check "on blast" it will play even if you are away from keyboard. This could annoy your mother big time LOL.
   You can configure this by going to setup -> general -> on join auto start (/ow.spr 1)
3. Now spr will start auto start with playlist IF you were playing songs from playlist previously AND there is one or more songs in your playlist. Otherwise it will start random play.
4. The list producer will check if you have any file which has a double space in path or filename. If there is any, the script will open a window and display there. Script cannot play, send, or correct double spaced filenames. So you have to open window explorer and fix manually. Also, you will have popup on the window "explorer" (right click on the window)

[what's new in v8.02]
1. bug fix: getright 1) didnt update if spr of the server person is very old. fixed 2) didnt continue to download if filename has spaces. fixed.
2. bug fix: skin editor. didn't produce .skn file but .skns fixed
3. There is a fatal bug, which I can't publicly talk about, in all the previous spr versions. (can be used by malicious users) You have to upgrade. This is a MUST.

[what's new in v8.01]
1. In the filename editor, you could not replace parameter 1 with 2 if parm1 is entirely included in parm2. (e.g., celine_dion couldnt be replaced with (celine_dion)) But now you can replace it. So, NO LIMIT for replacing anymore.
2. In the filename editor, if you replace a "find" string without any "replace" string specified there, it will REMOVE the "find" string. So you can remove some strings from the file names.
3. In the filename editor, when you double clicked a single file, it just gave you a regular mirc input dialog. So you didn't have the original filename in the edit box. Now it will give you a dialog with the original filename. Just to make life easier.
4. Reorganized popup menu. In server control, there is also ads: dcc status and list/slot ads.

[what's new in v8.0]
1. Added a feature of Filename Editor in tools.

   This tool is designed for those who want to fix filenames in mass, Not one by one.
   There are two things you can do.

   "replace" button works exactly like replace in ms office word except it applies to filenames
   "front add" button will add the string in front of every file in the directory. 
   So if you have files without singer's name, you can easily edit the files. (e.g., 01. my heart will go on.mp3 becomes (celine_dion)-01. my heart will go on.mp3)
   You can be so smart that you can edit file names in every possible way.

2. When ppl ask que, it gave the time left for next send. But, it kind of lied when you are sending more than max slot (say, cuz of list sending). It gave the time left for the list send which doesnt mean your slot will be available. Anyway, now it will say N/A instead of the false time left.
3. Bug fix. (concerning the handling of playlist with wrong fileinfos)
4. In @Que.Control window, there were only move up and move dw. Now it has move to top and bottom
5. Now nicklist/channel popup has "server ctrl" section. Here, you can find Que ctrl which was in the tools section of the previous versions.
   But there is another thing: access ctrl. This can prevent certain users from accessing your server.
   Banmask there is *!*@host.domain (e.g., *!*@whatever.com) If a user is banned, he won't be able to access your server in no way. 
   The banlist will be effective until your next reboot of mirc.

[what's new in v7.9]
1. bug fix (concerning 2nd cps limit)
2. Getright will allow you to download not only mp3s but also other types of files 
   as long as they are in multimedia input setup. For example, if you want to d/l wav,
   for example, you should add .wav to input setup. (in general setup dialog)
   (WARNING) .mpg .mpeg are already included to .mp?. So DO NOT ADD THE mpg or mpeg extensions
3. winzip latest version doesnt unzip when the files have 4 digit which is stupid (cuz there ARE 4digit ext like mpeg) and causes a lot of troubles to its users.
   spr skins used to have .skns extension. It needed to be adjusted. So finally I gave up 4 digit ext. All your skins will be turned into .skn when you install spr. Also all skins in spr website are changed. 
   So dont get confused. From now on, it is .SKN NOT .SKNS
4. mIRC 5.61 has a bug of drawrect -rf command which resulted in drawing a rect one pixel bigger. I made an adjustment for this.

[what's new in v7.8]
1. Improved Playlist: 
   a) if the file infos in playlist are not correct, the previous version halted and gave you an error msg. Now it will try to remove the wrong ones and keep trying to play..
   b) +files in previous versions returned to "0 files added" if you change directory. Fixed
   c) +files now will not add if you choose the files that are already in your playlist, and selectively add only unrepeated files.
      (but be ware that still +dir or +all will add all files even if there are repetitions cuz it would be too slow if it checks out all the files of +dir or +all)
2. Improved Terminator: Now you can set another cps limit for terminator if filesize is too large. This will allow you to prevent slow users from accessing large files such as .mpg or .zip while still allowing fast users to access them. (even if you are not a fast server, you will be able to keep limit high for large mp3 files of 5 mb or larger) This setup can be done in general setup dcc server section.

[what's new in v7.71]
I finally got the bugs out. Sorry about the troubles 

[what's new in v7.7]
1. Opens up playlist +files window as a desktop. So you don't have to restore your mirc if it is minimized.
2. Added a 'Pause All Sends' button under dcc menu in setup dialog. If this button is pressed and you save it by clicking OK in setup dialog, your (auto) sends by SpR jukebox will be saved and will be resent when you later release the button by pressing it again. 
   This is intended for two things:
   1) Some ppl on slow connection will be able to temporarily pause sends and use their bandwidth and later restart sending dccs that they were supposed to send. 
   2) You can upgrade without losing current sending by pausing sends first and unload scripts and install the new one. One touch will start resending the dccs you were supposed to send. 
   In case of 1), ppl can change their nick while in case of 2) ppl cannot change their nick.
3. In general menu in setup dialog, you will have the option of whether you want to shoot ctcps to channel. This option is needed when ppl want to play in non mp3 channels, cuz they get kicked out for the ctcps by some obviously stupid scripts. The option of whether you want to see the echoes of others' ctcp is in display setup only, as it should be.

[what's new in v7.6]
1. In v7.51 you could send your list in zip. But you had to actually go into the folder and use popup menu to produce the zip file. Now the script will automatically produce the zip file for you. :)
2. Improved GUI interface (remote, playlist, history window)
3. When you are not in main chan, the previous version sent wrong msgs to server on dcc send/get events. Fixed.
4. Local Play won't pause/stop when you press the button from remote. Fixed
5. When you play from history(rwd window), if not any file played before, it gave you error. It will halt now. Fixed.
6. The sort option dialog of playlist was not centered. Fixed.
7. When the playlist has wrong file infos, it will halt and give you an error msg in titlebart istead of hiccupping with /aline insufficient parameters in status window.
8. The ziplist generator popup menu didn't appear when you chose to send in txt. Fixed. So you can now choose to zip list later on.
9. In getright download status window, you could download from the previously analyzed list. Now it also give you the option you can pick another list (for example, if you want to add from the new list you got from the target server after you already started getright)

[what's new in v7.51]
1. In 7.5 you couldn't double click to local play in playlist. Fixed
2. Now you will have an option to send your list in zip file rather than in txt file.
   I couldn't find a way to automatically produce a zip file from mirc. So here is what you should do now.
   When you are done with list make, it will prompt you to the question whether you want to make a zip.
   Click yes, and it will open window explorer minimized on your window task bar. Restore it and find your list.
   Click on your list and right click to popup. There should be "add to yournick[date].zip" in the popup menu.
   click on it. And come back to your mirc and click "yes". Now the script will send your list in zip.

... Old Version History got too long to show here. Sorry.

Any Questions or Suggestions: spinoc@xoommail.com