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.2.2.1 [Paradox]
* Bump TOC number for 3.2.2 (finally)
* Please report any issues that need to be fixed on the issues tracker of curse.com

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 :(