Wimpy Player Installation and License Agreement

PHP version: Tested with PHP version 4.3... so PHP version 4.3 is recommended, however I have had success with earlier versions of PHP... version 4.1 seems to be the lowest version that Wimpy will run on.

ASP version: Tested on Windows XP Professional with .NET installed. The ASP code is based onVBscript, so Wimpy "should" work on earlier version of Windows Servers.

LICENSE AGREEMENT

This software is the copyrighted material of Mike Gieson, Plaino, inc. This document is a license agreement. By running this software on your computer you agree to the terms of this license.

Mike Gieson, Plaino takes no responsibility for any damage that this software might cause.

This software is designed to provide access to collections of files. By using it, you agree to comply with all federal and state laws applicable to such content, as well as the terms of this license. You agree not to use this software to distribute or facilitate the distribution of unauthorized copies of copyrighted works.

If you disagree with any of these terms, you are not authorized to use this software. If you do agree with these terms, please enjoy.

The link above will also enable you to embed wimpy into another page on your Web site (outside of your mp3 directory).

Be sure to visit the "tools" section at www.wimpyplayer.com for addition helper tools -- such as the Pop Up Window Maker, Playlister and Skin Machine.

v5.2.3 Dec.7, 2005
- Fixed issue with certain PHP installations where cover art for individual files did not work properly.
- Added pls and m3u playlist parsing. You can now include a m3u (simple or extended) or pls playlist file in your wimpy folder and it will display in the player's playlist, and when clicked on wimpy will list and play the contents of the m3u or pls playlist.

v5.2 Nov. 22, 2005
- You can now "point" wimpy to another folder above or below the public document root. For the PHP version, use the wimpy_dir.php plugin. For the ASP version, edit the variable "startDir" in the wimpy.asp file.
- Set the default background to 60% alpha so that the Customizer tool can set background color.
- Corrected issue with files using an UPPER CASE MP3 extension being listed as a directory.
- Run wimpy off of a configs file. Set wimpy.swf?wimpyConfigs=http://www/path/to/wimpyConfigs.xml
- Added loop playlist options to customizer tool, and config.xml. Options are as follows: off, one, all
- Add https option. Configurable in the wimpy.php or wimpy.asp file.
- Added "block php info" option to PHP by default.
- Fixed bug with mp3 file's cover art not sizing properly if a default coverart file is present, and then an mp3's coverart loads and startplaying on load option is set. The two images loaded to fast, not giving wimpy a chace to reset itself.
- Fixed bug with freaky behaviour when clicking stop button. After clicking the stop button, then play button where "click to start" would not go away. Plus after clicking stop, track would not rewind to the beginning, Plus playlist would reset to the first track, but if you clicked play again, the track that was previously loaded would play even though the playlist appears to sho that the first item in the play list is selected.
- Fixed bug with startOnTrack through wimpyConfigs.xml
- Many other bug fixes

v5.0.16 Jul. 23, 2005
- Added External JavaScript controller functionality.
- Included additional features into the wimpyLoader, which allow you to create your own buttons and control the player.
- Fixed issue with "default image" option... fixed?
- Created Podcast Amp. A goofy little free tool to browse and listen to Podcasts from your desktop.

v5.0.12 Jul. 17, 2005
- Fixed bug with one item in a podcast
- Fixed bug with Fake EQ

v5.0.05 Jun. 29, 2005
- Corrected issue with older version of PHP, where files did not show up in the player (file_get_contents function).
- Corrected MySQL connection scripts.
- Corrected wimpy_podcast.php script.
- Optimized PHP performance.

v5.0.04 Jun. 27, 2005
New Features:
- Embed playlist into Wimpy Player HTML or JavaScript code.
- Play RSS / XML podcasts natively
- Optional external XML Configuration file
- Use multiple configuration files with a single install.
- Authentication script for the super-paranoid.
- MySQL "existing database" helper scripts
- Play / Pause toggle button
- "Random Playback" has been replaced by "Shuffle Playlist"
- Loop button has three states: Loop Playlist, loop single track and off
- Playlists no longer loop by default
- "First run" installation -- build configuration file immediately after uploading.
- Easy JavaScript "makeWimpyPlayer" for multiple instances on a page.
- Use Wimpy MP3 Player like Wimpy Button.
- Flash 7 compatible
- Resize the player without freaking out the skin.
- Startup logo is just a logo, not including the "wimpy" word.
- Visual link now defined by the "comments" tag in either the ID3 tag or Playlist "comments" tag.

v4.1 - Feb. 27, 2005
- Added optional "vote" button.
- Added "fake" graphic EQ to simulate a graphic EQ.
- Added Playlist scroll up/down buttons.
- Added ability to edit the start up text via Skin Machine.

v4.0.32 - Feb. 13, 2005
- Fixed bug with ecommerce links (again) due to URLs being interpreted improperly.

v4.0.31.1 - Jan. 7, 2005
- Fixed bug with ecommerce links. ID3v1 tags were taking precedence over ID3v2 tags, which cause the ecommerce link to truncate at 30 characters in the PHP version.

v 4.0.31 - Dec. 10, 2004
- Added option to stop after each track (only available through the customizer tool. No button on the player)
- Added "force XML compliance" option so people can build their own back-end app to connect to the wimpy front-end.
- Added "default jpg" in the case that there is not an image in a given folder / per graphic, the player will default to, well, the default image,rather than maintain the existing image.
- Fixed bug with demo: scrubber grabber scrolls off screen.
- Fixed bug with demo: long text in info display would over run into the time.
- Changed the way skin.xml files are handled. Rather than dropping a skin.cml file into the wimpy folder, one must enter the http://www/path/to/skin.xml. This allows for using skins with XML playlists, and is generally much more versatile.
- XML files that have "skin" in the file name are automatically hidden from wimpy.php/asp.
- Moved the ID3 extraction out of the main script and into a separate collection of files. Now using getID3() by James Heinrich as a separate library.

v 4.0.18 - Sept. 17, 2004
- Revamped wimpy so that it can accommodate skins.
- Added support for non-western characters.
- Added option for preventing mp3s from being locally cached by the end user.
- Added option for ecom window.
- Created Skin Machine so that users can easily customize the design of the player.

v 3.2 - Sept. 24, 2004
- Added support for non-western characters.
- Added option for preventing mp3s from being locally cached by the end user.
- Added option for ecom window.
- Fixed bug with loading cover art graphics.
- Brought ASP version up-to-par with the PHP version.

v 4.0.18 beta - Sept. 17, 2004
- Retooled wimpy so that it can be skinable.
- Created Skin Machine so that users can easily create and modify customized the skins.

v3.05 - August 4, 2004
- Enabled wimpy to be used with a shopping cart system. (Set the "comments" ID3 tag or the XML "comments" field to the URL for your shopping cart item.)
- Added auto detect visual capacities. Simply drop an image named "coverart.jpg/swf" into the root of each mp3 directory/sub-directory. Or if you wan to use an individual image for each track, drop in a jpg/swf file with the same name as the mp3
- Added support for the following non-western characters: ^ ~ `
- Fixed volume control "weirdness"
- Fixed "sticky scrubber" and "diamond shift"
- Add the "smart" random so that wimpy "knows" which tracks have been selected and won't re-play randomly selected tracks until all track have been played.
- Fixed Upper/mixed case discovery bug
- Fixed the "getMyid3info" bug
- Added support for "force download" for the ASP version
- Added support for Playlister "save to server" for the ASP version

v2.0.50 - June 24, 2004
- Re-vamped the MySQL connection scripts.
- Fixed bug with the playlist handle.
- Added the "Loop Current Track" button.
- Fixed weirdo error with Playlister - Some PHP installations require a "GET" method, others do not.

v2.0.47 - May 25, 2004
- Streamlined the Library within the FLA source to provide easier editing / skinning.
- Added "Force download"option rather than popping the track into a "_BLANK" page, PHP will now try and force the download so the user can save it to their local machine.

April 2004
- Created Wimpy AV - a derivative of Wimpy that plays video -primarily the same basic code as Wimpy, but alterations were necessary to bring the actionscript code up to actionscript version 2 specs. Wimpy MP3 player still relies on actionscript version 1 to run properly.

v2.0.33 - March. 8, 2004
- Added support for some non-western characters: ä é
- Added support for MySQL database connectivity
- Create Wimpy for ASP
- Added option to display ID3 information in the playlist or simply the filename.

v2.0.32 - Feb. 22, 2004
- Retooled Wimpy's actionscript from the ground up. (i.e. removed the cludge factor)
- Added support for XML playlists
- Created Playlister to assist in building XML playlists.

v 1.8a - Jan 31, 2004
- Customization via HTML.
- Volume control fix for MAC users. (Volume settings were not carried over to the next song)

v 1.8 - Jan 22, 2004
- Added help pop-ups
- Fixed volume controls. (the volume would revert when the next song loaded + mute and full volume)
- Changed playlist item "double click action" to a single click
- Moved preferences into a query string that is passed into wimpy.swf via HTML.
- Demo in SWF and PHP.
- You can now move the wimpy.swf to another location outside of your wimpy folder by editing the HTML (rather than editing the source.fla fie).

v 1.7b - Dec 5, 2003
- redesigned the user interface to make it cooler--more like itunes.

v 1.7 - Oct. 14, 2003
- added some additional troubleshooting variables... have been able to get wimpy working with PHP version 4.06 by setting troubleshoot2 to true.
- added a directory filter, so you can hide particular directories from wimpy... especially good for people who have ugly front page directories hanging around.
- added an option in the wimpy.fla so that you can randomly select the first song to play from the playlist--then the rest of the songs will play in order.
- moved the customization features to the PHP page for easier editing

v 1.6 - Aug 19, 2003
- included a download button so that users can download the source.mp3 file. This feature can be disabled through the wimpy.fla file by double clicking the wimpy player and on the "options" layer changing the variable: displayDownloadButton = true; from true to false.
- PHP revisions to accommodate different version of PHP + troubleshooting.

v 1.5a - Aug 18, 2003
- PHP revisions only.
- added troubleshooting for legacy PHP version.
- included action to display PHP info (wimp.php?action=phpinfo)

v 1.5 - Aug 2, 2003
- retro fitted the PHP so that it works under earlier versions of PHP (tested on PHP version 4.0.5. -- thanks to http://www.nilsellis.com for letting me test on his server).
- Made a new skin that makes wimpy really small.

v 1.4
- removed the capacity to save id3 info to a text file... too much hassle for the end user, although obtaining the directly list and mp3 info does require more"resources"

v 1.3c
- fixed idiotic problem with 1.3.b (wimpy was reading any file other than "txt" and "mp3"). Du.

v 1.3b
- fixed filename issues where the filename contained characters incomparable with Flash.

v 1.3
- playlist now has id3 information
- a text file containing wimpy formatted id3 information is created for each mp3 file. This increase the speed it takes to get wimpy going and minimizes the overhead required to process mp3's numerous times.
- cleaned up the source FLA file so that it is easier to "skin"
- turned wimpy into a movie clip so that you can "copy and paste" wimpy into your existing FLA project.

v 1.0.6a
- Workin' out the functionality and the bugs.
- Tried out a new layout... based off of www.heavy.com's player :)

v 1.0
- The first release of the newer version which deviates from using playlists. Millions of bugs and very ugly code, but hey it works!

v 0.077 July 14, 2003
- It's feature rich! but functionally poor :(
- Its official, wimpy is a kludge. A broken mess that is impossible to install. Don't even think about editing the look and feel.

v 0.075 June 21, 2003
- Included the ability to edit the id3 tags of the actual mp3 file.
- code is starting to get out of hand.

v 0.062 Feb. 25, 2003
- This version works, but has some funky bugs.
- A big clunky player complete with editable playlists
- Still a little buggy

v 0.057 Nov 11, 2002 (the original release)
- Removed a little bit of the ugliness
- Should run with or without "register_globals"=On/Off

(If you've actually read down this far, the least i can do is provide you with some screen shots of these "museum" players : ) Click here to visit the museum.