NOTE: I do not recommend using the curse client to install this addon, it has a bad habit of erasing things, including your MP3s.......
SimpleMp3 Player for WoW 3.x is a highly functional in game music mod that lets you select and play your favorite songs using an intuitively simple interface. The main display features a song timer with scrolling name text, previous and next buttons, and a shuffle function. There's also an easy to navigate Playlist which simplifies song selection along with a volume slider featuring mouse wheel control. Each of these interfaces can be individually accessed and easily hidden away all with one simple click of the Mini-Map Button.
v3.1.0.10 [Paradox]
* Fix several minor Playlist issues.
* Fix several errors with the counters.
* Fix problem with music stopping on Death, and not starting again, as expected.
* Fix similar problem with Cinematics, please report other cases, with event names, if possible.
* Fix Sort by Length and Sort by Bitrate
* Fix typo in Voice Chat code
* Fix various small bugs
* Add buttons to playlist and library windows that allow you to sort directly, without going to Options.
* Add ability to select several tracks to add/remove (LeftClick + Ctrl to select tracks and press the new button) Once I got this working, I realized, it's kind of useless, but...
v3.1.0.9 [Paradox]
* Fix option for playing default music when not playing a song through SMp3.
* Create separate, invisible frame for handling all counters and events (OnUpdate and OnEvent) this may help speed up the overall interface, and allows the minimap button to be hidden without messing things up.
* Some other code cleanups.
v3.1.0.8 [Paradox]
* Fix typos related to interface sounds and using tags.
v3.1.0.7 [Paradox]
* Fix last minute typo that prevented Options from working correctly.
v3.1.0.6 [Paradox]
* Drop Beta in the name and description, might as well call it release
* Add option for music delay after entering the world, it is now set via a slider in the options panel. Range is from 0 to 60 seconds.
* Fix various other issues with playing on start/after a loading screen.
* Add All button while playing acts a bit better.
* Fix bug with one song on playlist not advancing (stop/start same song) when song ends.
* Above fix also fixes pressing next/prev with only one song in the playlist.
* Updated some documentation.
* Remove Cosmos Plugin, no one ever reported actually using this, anymore, and, if they want it, old versions of Smp3 are still downloadable.
* Prevent options at 0 or false from being recreated in rare cases, without the proper value. This fixes some issues with sound volume.
* Various other code cleanups, here and there.
v3.1.0.5b [Paradox]
* Fix several cases where The Volume slider wasn't acting as expected.
* Change exit button on the main form to close all open Simple Mp3 windows.
* Add Tooltips to some buttons on the main form.
* Add button (and functionality) for switching between time elapsed and time remaining.
* Fix issue with demoing a song from the Library with an empty Playlist.
v3.1.0.4b [Paradox]
* Fix reported errors concerning SliderVar and AddAll_button reported by TEDNIK
v3.1.0.3b [Paradox]
* Clean up Localization files
* If you exit with a song playing, it will now be started when you log back in, properly.
* If any of the windows are open (The Player, The Playlist, The Library, or, even the volume slider) they will now reopen when you log in again.
* Clean up a lot of code and move most reused code to its own function.
* Fix one old typo that didn't seem to break anything.
v3.1.0.2b [Paradox]
* Fix typo in ruRU localization file, reported by Kazragore.
v3.1.0.1b [Paradox]
* Update toc file for latest client version
v3.0.2.3b [Paradox]
* Fix Russian and Chinese localizations (hopefully)
v3.0.2.2b [Paradox]
* Fix bug with the options button (Fix supplied by Trysor)
v3.0.2.1b [Paradox]
* Increment version number to indicate compatibility with client 3.0.2
* Button text fixed, Playlist and Library text fixed, some other small fixes for 3.0.2 all supplied by Trysor (I'm unable to test them, let me know if there are any big problems...)
* Traditional Russian localization - Supplied by Kutensky
* Traditional Chinese localization - Supplied by s8095324
* Some minor changes to PlayListCreator, no need to regenerate Library or Playlist.
v2.4.3.1b [Paradox]
* Increment version number to indicate compatibility with client 2.4.3
* Hack to fix music stopping when zoning with loading screens (also starts the player on startup if you exited with a song playing previously)
v2.4.2.6b [Paradox]
* Changed Playlist Generator to allow Python to convert the unicode it can, please let me know if you get any "maps to undefined" errors.
* Code "modularized" a bit, shouldn't cause any problems, just makes it easier to work with.
* Code for interfacing with Cosmos moved to plugins directory, eventually other interfaces, like Titan and FuBar may be added.
* Playlist.lua is now SimpleMp3Library.lua this is part of making the playlist generator work for other mp3 players (if the author codes for it)
* Simple.Mp3.Playlist.Creator.vx.xx renamed to Playlist.Creator
* Added Music Library, so the play list creator actually creates your library, and you can add tracks to your playlist from it.
* Fixed an issue with clicking on empty space in the PlayList if you have fewer than 25 songs in it.
* Shift-Clicking an item in the Library will preview the song for 15 seconds (I had previously announced it would be 30, and soon, it will be set in the options by the user)
* PlayList generator coming closer to being more universal.
* Finally, an Options Panel.
* Sort Library or PlayList By Filename, Title, Artist, Album, Length, Genre, or BitRate Ascending or Descending
* Genre and BitRate now shown on the Playlist and the Library
v2.4.2.5b [Paradox]
* Fixed version.txt to have release date in June, not July :)
* Fixed a small error in the playlist generator that would cause an entire directory to be skipped if there was a unicode problem with one file.
* Save volume level on stop to be restored when play is pressed
* Changed the dimensions of the main interface to allow for 00:00:00 format, which means there is room for another button (possibly 2) on the main interface, any suggestions?
v2.4.2.4b [Paradox]
* Fixed Playlist generator unicode support (reverted an error introduced in last revision)
v2.4.2.3b [Paradox]
* Fixed (once again) a problem with resizing the playlist to smaller than 25 slots not showing the last songs on the playlist
* Added more unicode characters to be converted
* Updated the install instructions
* Fixed a few more small errors in the playlist generator
* Changed the playlist generator so the PlayList is already in the expected format (may speed up load time) deprecated "Song" function left in place for now
* Moved some hard coded English output to localization file, please submit translations, or let me know if I missed some text you think can be localized
* Small tweaks/fixes
* Found the reason some mp3s report the wrong length. If you have problems with songs being reported longer than they are, you need to download VBRfix from
http://www.willwap.co.uk/Programs/vbrfix.php
v2.4.2.2b [Paradox]
* Added some reporting to the playlist creator, so you can see how many errors there were, even if you answer n to both prompts
* Updated Simple.Mp3.Playlist.Creator.v0.10.txt in the Mp3 directory to reflect the contents of the main install.txt
* Replaced a big chunk of code that displays or hides songs on the playlist when it is resized with a much smaller one.
* Playlist can now be made small enough to display 1 song at a time
* Added some Unicode handling, if you come across a unicode error, please send me the info so i can attempt to add it to the list.
* Fixed a few typos in the playlist generator. (Thanks KazragoreDDS for helping me find at least one of them)
v2.4.2.1b Updates:
* Fixed a long standing issue with the slash commands, I guess no one really uses them, this bug existed before I took over....
* Added some error handling so it won't throw errors if the playlist is empty and you click on some buttons
* Shuffled Playlist is now saved and restored
* Using the shuffle button while a song is playing no longer stops the song and starts the new one.
* Forgot to update the install procedure in the last release to include turning off the "Hide extensions for known file types" stupidity
v2.4.2b Updates:
* Rewrote Playlist generator for better exception handling, Still can't add music with Unicode characters.
* Added Genre (not used yet)
* Added another option for showing errors (You can now hide Unicode errors, but still get other error messages)
* Certain settings are saved when you log off, and reloaded when you log back on (for each character)
* Fixed a visual issue with the scrolling text
* SimpleMp3 remembers what track you were listening to when you exited, and will load that song by default, unless the playlist has changed.
* Probably changed a few other things along the way that I should have written down as I worked on them....
* Incremented version number to reflect 2.4.2 compatibility
v2.4.18b Updates:
*Fixed an issue with shuffle mode (Thanks Riptides)
*Fixed the Playlist generator to (optionally) report errors during the playlist creation
*Added compiled version of the playlist generator for those who don't want to install the Python Framework
v2.4.17b Updates:
*Removed the files for the old playlist generator completely
*Fixed an issue with clicking on the last song on the playlist when 25 songs are visible
*Songs can now be kept in subdirectories
*Replaced tagger with id3reader, so id3v2 tags are now used instead of id3v1 (yuck)
*Started process of rewriting the code to cut down on duplicated code.
*Foundation for fully customizable display of playlist entries and scrolling text implemented.
*This doesn't mean you can customize it in this version, but, it will be easy to do so in a future update.
v2.4.16b Updates:
*Replaced the playlist generator with a python based playlist generator
v2.4.15b Updates:
*Fixed many of the issues with the playlist
*Fixed an issue with cutting 3 seconds off the end of songs (still not perfect yet)
*Changed timer display to support songs between 10 minutes and 59 minutes long.
*Fixed shuffle mode.
*Various code cleanups.
*Note Localization needed for this text, as well as any text in SimpleMp3 not localized, I'd hate to have to resort to babblefish or google translations :(
v3.1.0.10 [Paradox]
* Fix several minor Playlist issues.
* Fix several errors with the counters.
* Fix problem with music stopping on Death, and not starting again, as expected.
* Fix similar problem with Cinematics, please report other cases, with event names, if possible.
* Fix Sort by Length and Sort by Bitrate
* Fix typo in Voice Chat code
* Fix various small bugs
* Add buttons to playlist and library windows that allow you to sort directly, without going to Options.
* Add ability to select several tracks to add/remove (LeftClick + Ctrl to select tracks and press the new button) Once I got this working, I realized, it's kind of useless, but...
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...
