---------------------------------------------------------

jlGui : JAVA music player for Java platform.

Project Homepage :
http://www.javazoom.net/jlgui/jlgui.html
MP3 & JAVA Forums :
http://www.javazoom.net/services/forums/index.jsp
JNLP (JavaWebStart) configurator :
http://www.javazoom.net/jlgui/jnlp_configurator.jsp
Contact :
jlgui@javazoom.net
---------------------------------------------------------
INSTALLATION :
------------
To launch jlGui just double click under jlgui3.0.jar. If nothing appears try
"java -jar jlgui3.0.jar" command. If it still fail then edit jlgui.bat
(or jlgui.sh) script and setup JAVA_HOME variable before launching the script.
- To play local file or playlist : Left click on "Eject" button.
- To play remote file/stream : Right click on "Eject" Button.
- To load a new skin file : Left click on "Eject" button
or right click in top pop-up menu.
- To fill in playlist : Use the playlist front-end or open your
own M3U (or PLS) file.
You might notice that some features (buttons, pop-up) are not working. It's
because it has not been implemented yet (see TODO section at the bottom of
this file).
Have fun,
JavaZOOM Team.

CHANGES :
-------
11/14/2006 : jlGui 3.0
----------------------
- Spectrum/Time analyzer added through KJ 1.1.
- FLAC audio format support added through JFlac 1.2.
- Monkey's Audio format support added through JMac 1.74.
- Search in playlist feature added.
- UI code refactored :
+ Switch from AWT to SWING.
+ Skin class added.
- Preferences panel improved :
+ JavaSound device panel added.
+ Visual panel added.
+ Skin browser panel added.
+ System properties panel added.
- Pop-up menu improved :
+ Play File/Location added.
+ Playlist Editor switch added.
+ Equalizer switch added.
+ Jump to file added.
- Skin support improved :
+ RollOver on playlist pop-up menus.
+ Spline added to equalizer.
+ Drag&Drop support added to playlist.
+ Keyboard shortcuts added.
- jSpeex 0.9.7 included.
- VorbisSPI 1.0.2 included.
- MP3SPI 1.9.4 included.
- J2SE 1.6RC support added.

07/09/2005 : jlGui 2.3.2

------------------------
- Volume value property added in jlgui.ini.
- JLayer 1.0 included.
- MP3SPI 1.9.2 included.
- VorbisSPI 1.0.1 included.

04/27/2004 : jlGui 2.3

----------------------
- Equalizer feature added (for MP3 only) :
+ WinAmp skins 2.0 front-end compliant.
+ Presets
- Seek feature now available for both WAV and MP3.
- File Info feature improved :
+ Shoutcast ICY meta data support added.
+ ID3v1 & v2 tags loaded by MP3SPI.
- Design improved :
+ BasicPlayer redesigned (Threaded events, Audio properties).
+ Classes refactored.
+ Commons-logging added to manage traces.
+ jid3.jar dropped.
+ Pluggable TagInfo implementation.
(taginfo_mpeg_impl, taginfo_oggvorbis_impl properties)
- Bug fixes :
+ Last song endless loop bug for playlist fixed.
+ Black pop-up menu (under Un*x) bug fixed.
+ 8 bits WAV file support fixed.
- Skin support improvements :
+ Invisible components added.
+ Progress Bar, Volume and Balance display problems fixed.
+ Title marquee added.
+ "Loading" and "Buffering" messages added for stream loading.
+ screen_limit parameter added to display (or not) the player in screen.
- PLS support added for playlist.
- Save playlist on exit added.
- SPEEX audio format support added (jSpeex 0.9.3 included).
- VorbisSPI 1.0 included.
- MP3SPI 1.9.1 included.
- J2SE 1.5.0 beta support added.

07/01/2003 : jlGui 2.2

----------------------
- OGG comments and ID3 tags viewer added.
- PlaylistUI up&down buttons added.
- Playlist interface improved.
+ setModified/isModified methods added.
+ setCursor method added.
- Shuffle implemented.
- VorbisSPI 0.7 included.
- JOrbis 0.0.12 included.
- MpegSPI 1.6 included.
(It fixes WAV file non-playing bug under JDK 1.4).
- Bug fix in "Add dir" feature under Linux.
- Bug fix in AudioInputStream closing.

04/01/2002 : jlGui 2.1.1

------------------------
- Drag and Drop support added.
- WinAmp Skins 2.0 support improved.
+ Minimize button added.
+ Double-click to play song from playlist added.
+ Add files to playlist from directory added.
+ Popup menu on title bar added.
- MPEG 2.5 support added through JavaLayer 0.2.0.
- JavaWebStart support added.
+ Default skin included in JAR file.
+ jlgui.jnlp sample included.
- Configuration setup improved.
+ Load custom jlgui.ini from file or URL added.
+ Load skin from URL added.
+ Load playlist from URL added.
+ Optionally run the playlist on startup added.
- API improved and online samples added to help developers.
- jlGui.sh script bug fixed.
- M3U support bug fixed to be 100% compliant with WinAmp M3U.

03/04/2002 : jlGui 2.1

----------------------
- Playlist UI added.
+ Main window, Scrollbar, Add File/Url, Inv/Crop/Remove Selection.
- WinAmp Skins 2.0 support improved.
+ Audio files filter added.
+ Dynamic skin and playlist loading added.
+ Playlist, Shuffle, Repeat, Equalizer buttons.
- Configuration file "jlgui.ini" added.
- Ogg Vorbis streaming support improved (VorbisSPI 0.6 + JOrbis0.0.11).
- MpegAudioSPI improved :
+ SYNC offset support added => ID3 tags skipped.
+ BitRate + total length in seconds info returned.
- License moved from GPL to LGPL.

10/01/2001 : jlGui 2.0

----------------------
- MP3 streaming support for Shoutcast/Icecast added.
- Ogg Vorbis support added.
- Playlist implementation and M3U support added.
- JavaLayer 0.1.1 included to improve MP3 support.
- WinAmp Skins 2.0 support improved.
- Seek bar added (for WAV files only).

05/14/2000 : jlGui 1.0

----------------------
- jlGui is now open source (GPL).
- JavaLayer 0.0.8 included.
- MpegAudioSPI (from tritonus.org) included.
- 70% WinAmp skins compatible.

TODO :
----
+ Playlist :
- Improve "Add Dir" feature :
You have to select a file in a directory to select the parent directory.
- Make playlist resizable.
bottom-right drag is not implemented.
- Tiny play/pause/stop controls in playlist are not implemented.
- PLS (Load/Save) buttons in playlist are not implemented.
- MSC buttons in playlist are not implemented.
- Add title bar to move/close it.
+ Improve equalizer :
- Equalizer works only for MP3.
- Equalizer graph function is not implemented.
- Auto button not implemented.
- Add title bar to move/close it.
- Left slider not implemented.
+ Improve seek feature :
- Seek support works only for MP3 and WAV.
It means implement skip(bytes) in underlying SPI.
+ Improve pop-up menus :
- "Preferences" and "skins" items in title bar pop-up are not implemented.
- popupmenu.show() blocks player thread (in progress(...) method).
+ Player
- Add visualization.
- The middle button (in between iconify and close) not implemented.
- Make all windows (equalizer, player, playlist) move independantly.
- Upper far left button not implemented.

KNOWN PROBLEMS :
--------------
- MP3 : 99% of MP3 plays well with JavaLayer but some (1%) return an
ArrayIndexOutOfBoundsException while playing.
It's a bug (hard to fix) in the underlying JavaLayer decoder.
- Ogg Vorbis :
+ Low sampling rates such as 14Khz are not supported.
+ AudioInputStream is closed at the end of song for some
(only a few) icecast streams.
- Player :
+ It takes much more CPU under MacOSX (~70%) than under
Windows, Linux, Solaris (~10%).
+ Pop-up menu blocks the playback thread (temporary).
+ Pop-up right click doesn't work under Linux
=> Use Right click + Left click to select an item.