You are on page 1of 4

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

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.

+ Progress Bar.5.9. + Title marquee added. + Spline added to equalizer.Equalizer feature added (for MP3 only) : + WinAmp skins 2.ini.OGG comments and ID3 tags viewer added. .3. + Black pop-up menu (under Un*x) bug fixed.0.0 beta support added.SPEEX audio format support added (jSpeex 0.3 included). + Pluggable TagInfo implementation.PlaylistUI up&down buttons added. . . . .JLayer 1.Seek feature now available for both WAV and MP3.MP3SPI 1.jar dropped.VorbisSPI 1.Bug fixes : + Last song endless loop bug for playlist fixed. + 8 bits WAV file support fixed. . . 07/01/2003 : jlGui 2. .2 included. . + Commons-logging added to manage traces.9.0 included.VorbisSPI 1. .0 included. (taginfo_mpeg_impl.2 ------------------------ . .1 included. + setCursor method added.2 ---------------------- . 07/09/2005 : jlGui 2.MP3SPI 1.J2SE 1.7 included.Skin support improved : + RollOver on playlist pop-up menus. .Volume value property added in jlgui.Playlist interface improved. .jSpeex 0. .Design improved : + BasicPlayer redesigned (Threaded events. . + setModified/isModified methods added.Skin support improvements : + Invisible components added.0 front-end compliant. + Keyboard shortcuts added. . + Drag&Drop support added to playlist. . taginfo_oggvorbis_impl properties) . + jid3.MP3SPI 1.1 included. Volume and Balance display problems fixed.File Info feature improved : + Shoutcast ICY meta data support added.Save playlist on exit added. .0. + "Loading" and "Buffering" messages added for stream loading. 04/27/2004 : jlGui 2.J2SE 1.6RC support added.2 included.9.PLS support added for playlist.9. .4 included. + ID3v1 & v2 tags loaded by MP3SPI. + Classes refactored. + screen_limit parameter added to display (or not) the player in screen. Audio properties).3 ---------------------- ..VorbisSPI 1. + Presets .9.

. .6 included. . .0 ---------------------- . . .ini" added. + Optionally run the playlist on startup added.JOrbis 0. .jlGui. . .0 support improved. .0.WinAmp Skins 2. 04/01/2002 : jlGui 2. + Load playlist from URL added. + Default skin included in JAR file. .ini from file or URL added.1 ---------------------- .Ogg Vorbis support added. .jnlp sample included. + jlgui.12 included.0.6 + JOrbis0.MPEG 2.1 included to improve MP3 support. . . .Seek bar added (for WAV files only).WinAmp Skins 2. 10/01/2001 : jlGui 2.Ogg Vorbis streaming support improved (VorbisSPI 0.0 support improved. + Popup menu on title bar added.Playlist implementation and M3U support added. + BitRate + total length in seconds info returned.7 included.0. + Audio files filter added. Shuffle. Inv/Crop/Remove Selection.VorbisSPI 0.jlGui is now open source (GPL).0 ---------------------- . . + Load skin from URL added.MpegSPI 1.WinAmp Skins 2.JavaLayer 0.Playlist UI added. 05/14/2000 : jlGui 1. + Main window. .Shuffle implemented.5 support added through JavaLayer 0. (It fixes WAV file non-playing bug under JDK 1. ..4).Configuration file "jlgui. .2.0 support improved. + Playlist.JavaWebStart support added.sh script bug fixed. Repeat. Scrollbar. + Dynamic skin and playlist loading added.License moved from GPL to LGPL. . + Load custom jlgui.11). + Add files to playlist from directory added.1. + Minimize button added. .1.Bug fix in AudioInputStream closing.Drag and Drop support added.Bug fix in "Add dir" feature under Linux.1 ------------------------ . Equalizer buttons.API improved and online samples added to help developers.M3U support bug fixed to be 100% compliant with WinAmp M3U.Configuration setup improved. 03/04/2002 : jlGui 2. . Add File/Url. . + Double-click to play song from playlist added.MP3 streaming support for Shoutcast/Icecast added.MpegAudioSPI improved : + SYNC offset support added => ID3 tags skipped.

0. It's a bug (hard to fix) in the underlying JavaLayer decoder. player. . Solaris (~10%).JavaLayer 0. + Pop-up menu blocks the playback thread (temporary). . .. .Make all windows (equalizer.Make playlist resizable. . bottom-right drag is not implemented. .popupmenu. . + Improve pop-up menus : .MpegAudioSPI (from tritonus.MSC buttons in playlist are not implemented."Preferences" and "skins" items in title bar pop-up are not implemented.Ogg Vorbis : + Low sampling rates such as 14Khz are not supported.Tiny play/pause/stop controls in playlist are not implemented.Add title bar to move/close it. playlist) move independantly.Seek support works only for MP3 and WAV. . . .show() blocks player thread (in progress(. . .org) included.The middle button (in between iconify and close) not implemented.70% WinAmp skins compatible. . + Improve equalizer : .Auto button not implemented.Left slider not implemented. + Pop-up right click doesn't work under Linux => Use Right click + Left click to select an item.Equalizer works only for MP3.Player : + It takes much more CPU under MacOSX (~70%) than under Windows.Upper far left button not implemented.Add visualization. It means implement skip(bytes) in underlying SPI. . TODO : ---- + Playlist : . .. + Player .8 included. + Improve seek feature : . .Add title bar to move/close it.Improve "Add Dir" feature : You have to select a file in a directory to select the parent directory. . Linux.PLS (Load/Save) buttons in playlist are not implemented.. + AudioInputStream is closed at the end of song for some (only a few) icecast streams.) method). .MP3 : 99% of MP3 plays well with JavaLayer but some (1%) return an ArrayIndexOutOfBoundsException while playing. KNOWN PROBLEMS : -------------- .Equalizer graph function is not implemented.