Ptaak

List4Spr

[FekLar]'s FAST external list generator for SpR Jukebox

Features:

Amazingly fast list generation as compared to using mIRC and SpR.
Automatically reads the proper variables and values from mIRC and SpR: your SpR serving directories, your nickname, and the types of files you want to serve. (*.mp?, *.zip, *.rar etc...)
No more N/A in your file list: List4SpR's file scanning as not only much faster than SpR's, it is more accurate. List4SpR uses XAUDIO's XANALYZE library for blazing fast and accurate bitrate and file information scanning.
Automatically updates the proper SpR variables in remote.ini and SpRcounter.ini.
Allows you to add custom header and footer text to your list.
List4SpR allows updating more than one mirc. in the same session.
List4SpR makes backup copies of your configuration files.

Installing List4SpR:

You will need a copy of WinZip to extract the files.

Extract all the files into a directory, any directory as long as they all go to the same directory. Make a new subdirectory of mirc named List4SpR and extract the files there, or extract the files to \mirc. If you are running Windows 98, you might want to call up Windows Explorer and drag the List4SpR.exe file to the icon bar in the taskbar for easy access.

Then BACK UP all the files in your mIRC directory, and all the files in your SpR directory. This is a BETA TEST release  version, and although it has performed flawlessly so far it may contain as yet undiscovered bugs. At the very least, back up your remote.ini file in your mirc directory and your SpRcounter.ini file in your SpR directory. These are the two files that List4SpR must read and write to update SpR with the new list.

After you do this, create a shortcut to the List4SpR.exe file and put it on your taskbar, start menu, or desktop, or run the file directly from explorer. You can't run it form the Zip file, because the DLL files won't be extracted and available.

Run the program. If it can't find c:\mirc, you will be presented with a dialog that asks for the location of your mIRC directory: enter it. If it can't find XANALYZE.DLL, it will send up an error message window, and refuse to run until you have installed it. The error window contains a link to the XAUDIO site, where you can download the XAUDIO SDK file for Windows 95/98/+.  Click the link to go to the XAUDIO site, download the SDK ZIP file, call up WinZip, and extract the XANALYZE.DLL file to the same directory you extracted List4SpR, or to windows\system.

[FekLar] apologizes for the size of the List4SpR files, but this is a beta test release. The final release will not use or contain the DLL files, but for now it is being compiled in full debug mode, and not using the Borland DLL files require a release compile rather than a debug compile. The final release will therefore be smaller in size, (and even faster). List4SpR was written with Borland C++ Builder 3. If by some freak chance you have any Borland compiler installed on your system, you can probably leave the DLL files in List4SpR.zip in the Zip file: the files already exist on your system.

Running List4SpR:

There is what is obvious, and then what is not obvious. If you are one of those people who doesn't believe in help files, skip to the What is not so obvious section below.

What is obvious:

After you get the XANALYZE.DLL file installed, List4SpR will finally let you get in to the main screen:
 
 








The first thing you want to do is to verify that the correct mIRC directory has been chosen. If you decide to select a different mIRC directory, click Reload settings from SpR to update List4SpR with the proper values.

If you want custom header or footer text, choose the location of the file. The selection window will only allow files with an extension of *.txt to be selected. Text entry is not allowed in any selection area of List4SpR. If you try to type the name of a mIRC directory or header or footer file or nickname, the text will be rejected. Use the Change buttons to bring up selection dialogs instead.

Verify that your SpR serving directories and file types are correct. If they are not correct, call up mIRC, enter the correct values there, and then click Reload settings from SpR to update List4SpR with the proper values.

Updating mIRC / SpR should work whether mIRC / SpR is running or not.

If it works one way for you but not the other, please send a bug report.

However, if you have been sending the list as a text file but decide to change it to sending as a Zip file or vice-versa, then it is better to shut down the mIRC you want to update before performing the update, or SpR may not recognize the new settings.

Make sure your nickname is correct, and select the options you want to include. It may not be wise to check the ID3 comment field, depending on the types of comments in your files, and who you expect to see them. This option may be gotten rid of in the next release. Send [FekLar] your opinion regarding this.

After yo are sure that all the settings are correct, click Generate to begin generating the list. As the list is being generated, you can scroll the display window at the bottom to see the file info as it is being produced.

When the list generation is complete, click the Update button to write the new settings to mIRC and SpR, then you can shut down, fire up your SpR server, and be glad it only took 1/10th to 1/40th the time it normally used to take to build the list.

What is not so obvious:

Once the list is generated, it is stored in RAM. No file writes of any kind have taken place yet. You must click the Update button to actually write out the file and update the mIRC and SpR settings.

This is by design. If you have five different mIRC directories that all have the same serving directories, this allows you to update all five, without having to generate the list five times. Simply choose each one in turn, and click the Update button for each one.

If the other mIRCs have different serving directories or nicknames, you will have to regenerate the list. This may be changed in a future version.

This is nice to have if you have a mIRC for dalnet, another for undernet, two more for bots, etc...

If you change anything except the mIRC directory, you will have to regenerate the list in order for the changes to be implemented into the list.

The question mark button next to full scan VBR files explains what full scan means.
 

Etc...

The Abort button will usually not respond instantaneously, especially early on: give it some time.

List4SpR saves the last ten nicknames, mirc directories, header files, and footer files. All the settings you had chosen and selected will remain so the next time you run List4SpR.  The registry key is:

\HKEY_LOCAL_MACHINE\Software\Massive Terraforming\List4SpR.

Notice: this beta version does not delete the old list files (a later version will).

It makes a backup of remote.ini and sprcounter.ini, and stores these in the spr directory, but these are overwritten each time the Update button is clicked. The development is still proceeding, and saving the last 1-10 (user selectable) files will likely be implemented soon.

This version is fully functional, more than enough to be put to use, so it is now in beta test release. As with any beta release, use it at your own risk. Even Microsoft says you use their release version software at your own risk...