mp3stuff
by Andy Dufilie


Note: This help file is not entirely converted and updated from the previous text format.


Information
   - Introduction
   - How to install
   - Commands
   - Fixes & Additions
   - Website & Contact info
Main dialog
   - Play Queue
   - mp3 History
   - Playlist Editor
   - mp3 Search
   - File Browser
Options dialog
   - Version Checking
   - System
   - Playlist
   - Dialogs
   - Popup menu
   - Local echos
   - Play message
   - Timed channel ad
 
   - File serving
   - File queues
   - @Find/@Locator
   - File serving msgs
   - File serving list
   - Search directories
   - File types
   - mp3 Player
Introduction

Started in mid-1999, mp3stuff is the result of over three years of work, on and off. The script has gone through several rewrites and drastic changes as I've tried to make the interface as easy to use and understand as possible.

Automatic updating
As I fix bugs and add features, mp3stuff can automatically download and update itself, unobtrusively. This very convenient feature is what sets mp3stuff apart from other scripts. There is no hassle of visiting the website, extracting an archive, and reloading the script.

A focus on playing mp3s
The focus of mp3stuff is actually playing mp3s, with file serving as a secondary feature. The main dialog has five tabs with useful features for playing your mp3s.

Compatibility
mp3stuff is compatible with all versions of mIRC 5.71 and after. You should also be able to use it with any other script loaded. There is a very small percentage of scripts that will cause problems with it, but most likely it is not mp3stuff causing the problem. All reasonable precautions have been made to assure compatibility.

All filenames are supported
Unlike most mIRC scripts, mp3stuff supports files that have double-spaces in their names. It also supports variable bitrate mp3s.

Passive DCC send
mp3stuff also supports Passive DCC send (pasvdcc.mrc by vague) for sending files from behind a firewall or network.
You can get it from this address: http://pages.cthome.net/pdufilie/irc/pasvdcc.mrc
Simply load it and mp3stuff will use the /psend command for its file serving.

Limitations
The following limitations will remain in mp3stuff:
- mp3stuff will play mp3 files only.
- mp3stuff will not support multiple IRC connections.
- mp3stuff will not use any DLLs.

[Back to top]


How to install

This script requires mIRC32 v5.71 or newer. The newest version of mIRC is available here.

You can install mp3stuff from any directory; just extract all the files and include the path when you use the load command.

Example: Extract the files to c:\my folder\ and type /load -rs "c:\my folder\mp3stuff.mrc" in mIRC.

[Back to top]


Commands

Parameters surrounded by []'s are optional. For all [0|1]'s, a 0 means 'no', and a 1 means 'yes.'

Help: /mp3stuff help
Opens this help file.

Main dialog: /mp3stuffs [1-5] or /mp3stuff <1-5>
Opens the main dialog with the play queue, mp3 history, playlist, mp3 search, and file browser.
- If a number is specified, it opens to that tab.
- When using /mp3stuff, the number is required. /mp3stuffs does not require a number.

Options dialog: /mp3stuffo
Opens the options dialog.

Remote control: /mp3stuffc [x] [y]
Opens the remote control dialog.
- [x] and [y] are the position of the dialog (Use -1 for default x/y).

Queue editor: /mp3stuffq
Opens the send-queue editor.

Update: /downloadmp3stuff
Installs the newest version.

Next mp3: /mp3stuff next
Opens the next mp3 in the play queue, or a random one if the queue is empty. Continuous play will be enabled. Same as clicking on 'next.'

Spam: /mp3stuff spam [#|nick]
Spams your play message. If no channels are specified, then it uses your current channel setting.

Channel ad: /mp3stuff ad [#]
Sends out your custom channel advertisement.
- Separate multiple channels by commas (no spaces). Use "<all>" for all channels or "<active>" for the active window.

Start channel ad timer: /mp3stuff start_ad
Starts the timer that sends your channel advertisement.

Stop channel ad timer: /mp3stuff stop_ad
Stops the timer that sends your channel advertisement.

Make list: /mp3stuff list [0|1] [0|1]
Updates your mp3 list.
- The first [0|1] specifies if you want full info or not.
- The second [0|1] specifies if you want to record the length of time it takes to create the playlist. The time will be shown at the end of the file.

List filename: $mp3stuff(list)
Returns the path and filename of your current list, surrounded by quotes.

"Local, choose" mp3: /mp3stuff lc
Opens the file browser & turns off auto-spam.

"Public, choose" mp3: /mp3stuff pc [#|nick]
Opens the file-selecting dialog & turns on auto-spam.
- Separate multiple channels or nicks by commas (no spaces). Use "<all>" for all channels or "<active>" for the active window.

"Local, random" mp3: /mp3stuff lr [0|1] [0|1]
Opens a random mp3 with auto-spam off.
- The first [0|1] specifies continuous play.
- The second [0|1] specifies a forced enqueue. Use 1 for 'forced enqueue' and 0 for 'play immediately.' If not specified, 'enqueue by default' setting will be used. Forced enqueue turns continuous play on.

"Public, random" mp3: /mp3stuff pr [#|nick] [0|1] [0|1]
Opens a random mp3 with auto-spam on.
- Separate multiple channels or nicks by commas (no spaces). Use "<all>" for all channels or "<active>" for the active window. Use %mp3stuffplayto for current channel/nick list.
- The first [0|1] specifies continuous play.
- The second [0|1] specifies a forced enqueue. Use 1 for 'forced enqueue' and 0 for 'play immediately.' If not specified, 'enqueue by default' setting will be used. Forced enqueue turns continuous play on.

Find mp3s:
To open a hidden window listing mp3s matching a wildcard: /mp3stuff findmp3 <wildcard>
Return the number of results: $mp3stuff(findmp3)
Return one result: $mp3stuff(findmp3,<number>)
Close the hidden window: /mp3stuff findmp3

[Back to top]


Main dialog

The main dialog has five tabs with controls underneath that apply to all of them.

About "dead" files
If mp3stuff tries to play an mp3 and it no longer exists in the given path, it will try to find it in your search directories.

Spam: (checkbox)
Enable this checkbox to automatically spam your play message to the channels in the edit box.

Chans (button)
Click this button to pick channels from the ones you're currently on.

Spam! (button)
This button will spam your play message to the specified channels.

Mute (checkbox)
Mute allows you to spam your play message without listening to the mp3s. This is for advertising your files only.

Enqueue on double-click (checkbox)
This option is the same as "Enqueue by default." When you double-click an mp3 in the main dialog while an mp3 is playing, it will be added to the play queue instead of interrupting the current mp3.

Continuous play (checkbox)
When continuous play is enabled and an mp3 plays to the end, the next mp3 will open. First, the play queue will be checked. If that is empty, then the playlist will be checked. If the playlist is also empty, then a random mp3 will be selected from your search directories.

Enqueue selected (button)
This will add the selected mp3s to the play queue. When using the File Browser, selected m3us and directories will also be added.

Add selected to playlist (button)
This will add the selected mp3s to the playlist. When using the File Browser, selected m3us and directories will also be added.

Options (button)
Opens the options dialog.

Close (button)
Closes the dialog.

For an explanation of the five tabs:
   - Play Queue
   - mp3 History
   - Playlist Editor
   - mp3 Search
   - File Browser

[Back to top]


Play Queue (Main dialog)

This is a list of mp3s that will play in order when continuous play is on.

Open random (button)
This button will pick a random mp3 from the play queue and open it immediately.

Move selected: To top, Up, Down, and To Bottom
These four buttons allow you to arrange the mp3s in the play queue.

Stop at end (checkbox)
With this option enabled, continuous play will turn off after the play queue is emptied.

Shuffle (checkbox)
When the shuffle option is enabled, random mp3s will be selected from the play queue instead of the top one.

Remove (button)
This button will remove the selected mp3s from the play queue.

[Back to top]


mp3 History (Main dialog)

This is a list of the mp3s you have recently listened to.

History length (button)
Click this button to set the maximum length of the mp3 history. Default is 200.

Remove selected (button)
This removes the selected mp3s from the history.

Open random (button)
This will open a random mp3 from the history.

[Back to top]


Playlist Editor (Main dialog)

Options
This will open the options dialog to the playlist section.

Add directory
Adds all mp3s in a directory (sub-directories included).

Add wildcard
Adds all mp3s in your search directories that contain a certain string.

Remove selected
Removes the selected mp3s.

Remove directory
Removes all mp3s in a directory (sub-directories included).

Remove wildcard
Removes all mp3s that contain a certain string.

Remove dead files
Removes all files that no longer exist (they have been deleted, moved, or renamed).

Save copy
Saves a copy of the playlist to a file (.m3u).

[Back to top]


mp3 Search (Main dialog)

Search (edit box & button)
- You can type a search string and press enter to list matching mp3s in your search directories.
- Wildcards may be used in the search string. A "?" will match any one character, and a "*" will match zero or more characters. Spaces will be replaced with "*"'s.
- You can use the following command in mIRC to search for mp3s: /mp3search [search string]

List all (button)
- This will list all the mp3s in your specified search directories.

Directories... (button)
- This will open the options dialog to the search directories tab.

Open random (button)
- This will open a random mp3 from the search results.

[Back to top]


File Browser (Main dialog)

Current directory (edit box)
- The current directory is displayed at the top of the dialog and the contents are below.

Parent directory (..) (button)
- Click this button to display the contents of the parent directory.

Drive letters (drop-down menu)
- The drop-down menu in the upper-right corner allows you to browse different drives. Select 'refresh' to refresh the current directory and scan for drive letters again.

Refresh (button)
- This will refresh the directory contents and drive letters.

Directory contents (list)
- Directories are surrounded by []'s. mp3s and m3us are listed after.
- Double-click or press enter when you have a directory selected to view the contents of it. Double-clicking on "[..]" will take you to the parent directory.
- Type a letter to go to the next mp3 or m3u starting with that letter.
- When an mp3 is selected, the info for it will be displayed at the bottom of the dialog.
- When an m3u is selected, the number of mp3s in it will be displayed.
- Double-click on an mp3 or m3u to select it and close the dialog.
- m3us will always be added to the play queue.

[Back to top]


Version checking (Options dialog)

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

Install newest version (button)
- Click on this button to download and install the latest version.

Check on startup (checkbox)
- The script will check for a new version every time you open mIRC.

Auto-Install (checkbox)
- When a new version is found, the script will download and install it automatically.

[Back to top]


System (Options dialog)

Stop at end of play queue
- This will turn continuous play off at the end of the play queue.

Shuffle play queue
- This will play the mp3s in the play queue in random order.

Enqueue by default
- This lets you choose what mp3stuff will do with an mp3 when it is ready to be played. If this option is enabled, then the mp3s will be placed in the play queue to be opened in order after the one that is currently playing finishes. Otherwise, mp3s will be opened immediately on selection, regardless if one is already playing.

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 interruptions
- This option only matters if listening is enabled and 'enqueue by default' is disabled. If you are currently listening to an mp3 and someone plays one to you, the mp3 will either be placed in the play queue if this option is disabled, or it will be opened immediately (interrupting your current mp3) if this option is enabled. If 'enqueue by default' is enabled, then mp3s being played by others will always be placed in the play queue to be opened later.

Use mp3 file info caching
- This will enable or disable the mp3 file info caching.

Clear cache
- This will clear the mp3 file info cache.


Use windows file dialog for mp3s
- You can use either the dialogs in mp3stuff or the windows file selecting system to choose mp3s and m3us.

Windows file dialog re-opens
- If enabled, the dialog will re-open after you select a file.


Replace underscores (_) with spaces when playing mp3s
- With this option, if your files have underscores in the filenames, they will be replaced with spaces in your play messages.

[Back to top]


Playlist (Options dialog)


'Edit playlist' button
- This opens the playlist editor, described at the end of this file.

Use playlist as random mp3 source
- Enables or disables playlist feature.

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

Restart playlist and continue when done
- When you have 'only play each mp3 in playlist once' enabled, and all the mp3s in the playlist have been played, mp3stuff can either stop playing or restart the playlist and continue.

[Back to top]


Dialogs (Options dialog)

...

[Back to top]


Popup menus (Options dialog)

mp3stuff adds popups to the Status Window, Channel, Nicklist, Query, and Menubar. Some popups have "»" or "«" in the name. Click on these to hide or unhide that group of options. Popups with "[ ]" or "[×]" in front of the name act like checkboxes. Click on them to toggle the option on or off. The rest of the choices will open a window or an mp3.

[ Next mp3 ]
- This appears above the 'mp3stuff' menu when an mp3 is in the play queue, or when an mp3 is currently playing and 'continuous play' is enabled.
- If any mp3s are in the play queue, this will play the next mp3 in the list.
- If the queue is empty, it will select a random mp3 and open it. If you have the playlist enabled, it will pick a random one from the playlist. Otherwise, a random one will be picked from your specified mp3 directories.

[Back to top]


Local echos (Options dialog)

Colors for <c> tags in echos, separated by commas
- Specify the numbers you want mp3stuff to pick from when choosing random colors for <c> tags in echos.

Enable random colors
- Normally, echos will use the info text color where <c> tags are. If this is enabled, it will use random colors instead.

'Save as...' button
- Saves the current list of colors to a preset with the name you want.

'Presets' drop-down menu
- Select a color list preset to load into the edit box.

'Remove' drop-down menu
- Select a color list preset to remove.


Custom listening echo

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

'Save as...' button
- Saves the current listening echo to a preset with the name you want.

'Presets' drop-down menu
- Select a preset to load the listening echo into the edit box.

'Remove' drop-down menu
- Select a listening echo preset to remove.


Bullet for other echos
- You can enter a bullet for other echos with the edit box. <c> and <d> tags will work here.


Default color for echos (<d>)
- The '+/-' buttons change the color.
- The 'default' button puts your normal text color in the edit box.

[Back to top]


Play message (Options dialog)

Colors for <c> tags in messages, separated by commas
- Specify the numbers you want mp3stuff to pick from when choosing random colors for <c> tags in messages.

Enable random colors
- This enables/disables <c> tags in messages.

'Save as...' button
- Saves the current list of colors to a preset with the name you want.

'Presets' drop-down menu
- Select a color list preset to load into the edit box.

'Remove' drop-down menu
- Select a color list preset to remove.


Custom play message

Send as action
- This will send the play message as an action instead of normal text.

Mute when playing
- This allows you to play mp3s to a channel without listening to them yourself. Mute will be turned off when you click on a popup or button to listen to an mp3.

Send mp3 ctcps
- This allows others to hear your mp3s if they have an mp3 with the same filename and an mp3 script that supports mp3 ctcps.

Echo mp3 ctcps
- You can have mp3stuff display the mp3 ctcps being sent or not with this option.

'Save as...' button
- Saves the current play message to a preset with the name you want.

'Presets' drop-down menu
- Select a preset to load the play message into the edit box.

'Remove' drop-down menu
- Select a play message preset to remove.

[Back to top]


Timed channel ad (Options dialog)

Custom timed channel advertisement
- You can enter a channel advertisement to be sent to all channels in your 'play to' list (the edit box on the remote control, and in the mp3 selecting dialog).

Start ad now, and on startup
- When you turn this option on, your advertisement will be sent, and the timer will be started to send it again. The timer will also be started each time you open mirc.

Minutes
- The '+/-' buttons change the number of minutes for the timer. You can click on one, then hold down the enter key to keep increasing or decreasing it. The minimum is 1 minute and the maximum is 60.

'Save as...' button
- Saves the current play message to a preset with the name you want.

'Presets' drop-down menu
- Select a preset to load the play message into the edit box.

'Remove' drop-down menu
- Select a play message preset to remove.

[Back to top]


File serving (Options dialog)

Auto-send files when they are requested (Enable file serving) (checkbox)
- This will allows others to get mp3s from you by typing "! " into a channel or query with you. It also allows others to get your mp3 list by typing "@".
- 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, they can type "@Bob".

Total number of send slots (number)
- 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 requests an mp3 from you by typing "! ", the request will be placed in a file queue list, and it will be sent when enough files finish sending. They can check their queue status by typing "@-que", and remove their queued files by typing "@-remove [file name]" (file name optional).

Maximum send slots per user (number)
- You can limit the number of files that can be sent to a user at the same time.

Allow requests in queries (checkbox)
- This will enable or disable file serving triggers in queries.

Serve in all channels (radio button)
- This will ignore whatever is in the listbox, and enable triggers in all channels.

Serve in these channels only (radio button)
- This will only respond to file serving triggers in the channels listed at the right. To add a channel to the list, type it in the edit box and click the "Add" button.

[Back to top]


File queues (Options dialog)

Edit queue (button)
- This button will open a separate dialog that allows you to edit the file sending queue.

Length of queue list (number)
- Limits the length of the file queue list, as described above, under "number of send slots". If the file queue list fills up, no further requests will be recorded.

Max number of queues per user (number)
- You can limit the number of files that a user can have in your file queue list.

Friend list (Send files immediately, bypassing queues) (list)
- You can add or remove nicknames or addresses that you want to allow to get files from you without having to wait in the queue list.

[Back to top]


@Find/@Locator (Options dialog)

Respond to @Find/@Locator searches (checkbox)
- If this is enabled, then 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", "@Find s?ng", "@Find oo ong", "@Locator od?so", "@Locator go*ng"

Note to send with @Find/@Locator results (edit box)
- If you have specified a note and an mp3 is found by a @Find/@Locator search, the note will be sent with the results.

[Back to top]


File serving msgs (Options dialog)

Echo all messages that mp3stuff sends (checkbox)
- This option will cause all file serving messages to be displayed in the status window.

Echo file serving requests (in a window) (checkbox)
- This option will echo all requests to a separate window will open inside mIRC.

Respond to requests when features are disabled (checkbox)
- If auto-send or @Find/@Locator are disabled, this option will make mp3stuff reply to those requests, saying that the feature is disabled.

Message delay (Flood protection) (number)
- The script will delay for a number of seconds between each message it sends. You can change the delay with the +/- buttons.

[Back to top]


File serving list (Options dialog)

This section allows you to create a sorted list of the files in your search directories. The list will be separated into directories, so if your files are organized, the list will be too.

Nick used in list (edit box)
- This nick will be shown with a "!" before each file in the list. The list shows "! " for each file, for easy requesting. This nick will also be used in the filename of the list.

Include full file information (checkbox)
- This will include file size, length, kbps, khz, and mono/stereo information.

Create a .zip file (checkbox)
- This will compress the list into a .zip file. This requires an external program that supports command line parameters. You can modify the zip command in the edit box.

View current list (button)
- This will open your current list if you have made one.

Update list (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.

[Back to top]


Search directories (Options dialog)

Search directories
The directories you set will be used to find files. When people use @Find/@Locator/!nick file commands, mp3stuff will search only these directories. When a directory is set, all the sub-directories are included.

Excluded directories
Files in excluded directories will not appear in search results or file serving lists. Also, mp3s in excluded directories will not be chosen when the playlist is disabled and the script searches for a random file to play. Files in subdirectories will be excluded as well.

[Back to top]


File types (Options dialog)

mp3stuff will only play mp3 files, but you can list more file types in your file serving list and @find results. Adding new file types will not allow you to play them with mp3stuff. Enter a file extension in the edit box and click "Add ->" to add it.

[Back to top]


mp3 Player (Options dialog)

If the default player setting does not work for you, then you need to set an mp3 player. 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 off. Also, turn off the repeat option so the mp3s don't loop when finished.

mIRC internal (button)
- Uses mIRC's built-in mp3 support (for mIRC 5.8+), which depends on Windows Media Player. If this setting does not play mp3s properly, then it's probably an issue with Windows Media player.

External player... (button)
- Lets you select an mp3 player program.

Default external (button)
- Uses the program Windows has associated with mp3 files.

[Back to top]


Fixes & Additions

Versions are listed from newest to oldest.

2008.05.01
- Fixed a bug that prevented mp3s from being randomly selected from the playlist while the dialog was open but the playlist tab had not been clicked yet. (2008.03.18)
- Fixed bug in file browser dialog. Directory contents were not being displayed if the directory had double spaces in the name. (2008.02.11)
- Fixed bugs with Stuffamp.

2007.12.30
- Fixed bugs in the code that reads Xing VBR headers.
- Fixed bugs in the code that skips past the ID3 tags and reads the MPEG headers.

2007.10.27
- Fixed a bug where it was giving incorrect file info on some files with ID3 tags.
- Fixed a minor display bug that caused all spaces to be replaced with ?'s when adding an m3u to the play queue.

2007.08.23
- Updated the line of code that opens another copy of mIRC to use the required -i switch in mIRC 6.3. (Thanks to Derek for bringing this to my attention).

2007.08.03
- Fixed a bug in the 'extra' popups where it was incorrectly setting the spam channels to "all" instead of "<all>" (Thanks to Phillip).

2005.10.30
- Fixed a bug in the calculation of average bitrate and length of VBR files. (2005.04.23)
- Fixed a bug that caused the same mp3 to be played over and over when the playlist editor was open (Thanks to Robbi).

2004.06.03
- Added an option to set the maximum number of results to display for @Find/@Locator searches (requested).
- Added a command to open this help file (/mp3stuff help).

2004.04.29
- Fixed bugs in mIRC 5.71 related to the playlist (Thanks to HD).

2004.04.11a
- Added a popup option to stop the current mp3 (requested), but it only works with mIRC's internal mp3 support and Winamp. This option has also been added to the remote control, replacing the mute checkbox.
- Changed file serving code to use *!*@host instead of *!*user@host when determining open slots (requested).
- The <mp3 count> tag value was cached, but wasn't always being updated. The caching has been removed, so the bug is fixed (Thanks to mtec89).

2004.02.20
- Added a <folder> tag for mp3 play messages (requested).

2003.12.30
- Fixed bugs with file counting code (Thanks to James).

2003.11.24
- Fixed bugs with Stuffamp that were happening in mIRC 6.1+ (Thanks to Peter).

2003.11.23
- Added an option to change the font for the local echo and file request windows (requested). Right-click in the window for the option.
- Fixed a bug that happened when several search directories were specified (Thanks to anuwar).

2003.10.07
- Added an option to enable or disable the file serving requests window (under "File serving msgs" in the options dialog). It's now disabled by default.

2003.10.06
- Added commands to start and stop the timer for the timed channel advertisement.
- The option to start the channel ad timer when mIRC opens is now separated from the current status of the timer.

2003.04.29
- Changed </c> tag to <d>.
- Fixed a bug in the "Allow interruptions" option (Thanks to Samantha).
- Added an option to echo listening messages to a separate window opened by mp3stuff (requested).

2003.02.24
- Added an option to spam to the active window. Use <active> as the spam channel. There's a new button in the channel select dialog for it.

2003.02.21
- Added an option to pick a random play message each time you use the spam feature.

2003.02.19c
- Fixed a bug that appeared when auto-spam was enabled (the current mp3 would be re-played even though another was selected). It was a problem with a line I added to the spam alias.

2003.02.19
- Now when someone tries to queue the same file twice, there is a message saying it has already been queued (sed made me do it).
- Playlist opens and closes a little faster.
- @Find requests are a little faster.

2002.12.30
- Fixed a bug with file serving requests when *.* was specified under file types (Thanks to mruno).

2002.12.15a
- Fixed an issue with mIRC 6.0.

2002.12.15
- Removed support for mIRC v5.7. The options dialog got too big for it to handle.
- Fixed bug with adding files to playlist (Thanks to linx05).
- Added a feature: exclude directories. Searches will not return any results in excluded directories, and the file serving list will not contain files in these directories. Check the "Search directories" tab of the options dialog.

2002.09.01c
- Made mp3 search look at full pathnames when finding matches (requested). There might be an option to disable it in a future version.

2002.09.01b
- Fixed a bug with local echos.

2002.09.01a
- Fixed a bug in the timed channel advertisement.

2002.09.01
- Began converting the help file to HTML. It's a lot better now, right?
- Changed popups so it's easier to spam to the active window and change spam settings.
- Added an optional channel parameter to "/mp3stuff spam" command. Use "/mp3stuff spam [chan]"
- Improved the "Supported tags" dialog.
- Added <date> tag for the date you updated your mp3 list.
- Added <version> tag for mp3stuff's version number.
- Added options to list more file types with @Find/@Locator and in the file serving list (new tab in the options dialog).

2002.08.11b
- Fixed a bug with the popup options section in older versions of mIRC.

2002.08.11a
- Fixed a bug in the popup options.

2002.08.11
- Changed the way mp3 length is displayed from XXmXXs to XX:XX.
- Removed debug code in the list maker (forgot to last version).
- Modified popup menus to use real checkmarks in newer versions of mIRC.
- Added options for enabling and disabling certain popup menus, and some options for extra elements.

2002.08.09
- If you double-click an mp3 in the play queue that doesn't exist, mp3stuff will search for it in your mp3 directorys the same way it does when it plays the next mp3 in the queue automatically.
- Added options for main dialogs to be on the desktop or not, and always on top or not.
- Added an option for the <length> tag to use a custom alias. You can find it when you press one of the three 'View tags' buttons in the options dialog (under 'Local echos,' 'Play message,' and 'Timed channel ad').
- Fixed a bug in the mp3 searching cache.

2002.06.08
- Changed a timer to work around a bug in mIRC v6.02. Songs were getting cut off at the end because mIRC v6.02's timers are inaccurate.

2002.06.07
- Fixed bugs that appeared when using the new mIRC v6.02.

2002.05.21b
- Added controls to move mp3s up or down in the play queue.

2002.05.21a
- Fixed it so if you want to use another compatible mIRC mp3 player besides stuffamp (such as argh-amp), continuous play will now work properly. Previously, pause wouldn't work properly unless stuffamp was loaded.
- Fixed bug with "!nick file" requests where it wouldn't find the file if the request line had spaces where the file had underscores.
- Redesigned the options dialog. It's less cramped and easier to read now.
- Removed option for using windows file selection dialogs.
- Changed list command from "/mp3stuff ls" to "/mp3stuff list"
- Fixed bugs with mp3 CTCP listening.
- Removed feature that would start playing the next mp3 in the play queue when continuous play was turned on.
- Removed popup echos.
- Auto-install won't ask you to run initialization commands any more.
- Fixed file-queue bug.
- Changed <time> tag to <length>.
- Fixed a bug in the custom play message edit boxes in the options dialog.
- Added a file-serving queue editor, a popup that appears when appropriate, and a command to open the dialog (/mp3stuffq).

For information on old fixes and additions, visit this URL: http://pages.cthome.net/pdufilie/irc/mp3stuff_history.txt

[Back to top]


Website & Contact information

Website
    Visit my website to contact me:
    http://pages.cthome.net/pdufilie/

Please do not do any of the following:
    Do not ask me to write a new script for you.
    Do not ask me to help you write a script.
    Do not ask me to fix a script you wrote.

About including mp3stuff with your own work:
    If you want to include mp3stuff with your own script or on a website, it's alright with me as long as you do not change anything.
    If you only want to make a small change, such as disabling a feature, then you can ask me if I will add an option for it. Other users might want to disable the same thing.

About future versions:
    The code to mp3stuff is very messy and I've lost interest in mIRC scripting, so future updates will be small if I make any.
    I don't have time to add a lot of features, but bug reports are always welcome.

[Back to top]