                                                            
     `.:`     `:.        `:.                  ```  ````     
     `:+..` `..+/`..`...`.+:.`` `..```.``.` `.-.--.--.--`   
     `:+./:`-+-///:.//-//-/:-/:./:-/:`:/-/.  ```.-.-.``-`   
  `:.`-/.::`./-//-`./:-::-/.`-:-:.`-:`.::-    ``.-`..``-`   
  `-:---`-:--:.:---.-----.:-.--.--.--`--.-` `..`..`..`..`   
    ```   ```` `` `` ```  ```    ``   `  `    ```` `````    
                                                           
**************************************************JUKEBOX3D

Jukebox3D - 0.5.0
Player enhancer - Another way for displaying your playlist
------------------------------------------------------------

Compatible with: 
Rhythmbox, amarok, exaile,mpd with mpc

Licenses: 
- Jukebox3D, engine, artworks GNU/GPL 
- TTF Fonts are released under respective licenses, see license folder.

Author & contact: Sylvain Pasquet
Mail: pasquet.sylvain2@wanadoo.fr or sylvain.pasquet@gmail.com

Official website: 
http://j3d.linuxonfire.org

------------------------------------------------------------
Release notes:
------------------------------------------------------------
If you modify the current theme with the option window, don't forget to save the current theme or better you can
export it.

Once you have configure jukebox3D to your needs, you can start it without main gui with the 
--nogui command flag.
------------------------------------------------------------
------------------------------------------------------------
How to install:
Consult forum for up to date how-to install.
http://j3d.linuxonfire.org
Dependancy:
- GTK2
- Glade
- GTKGLEXT
- SDL_image and SDL_ttf
- curl
- libxml

make && sudo make install
------------------------------------------------------------
------------------------------------------------------------
Add your audio player:
You can contribute by creating a script for your audio player, you have an example in 'scripts/' folder. Shell script contains bash query 
for retrieve playing informations and manipulating playlist like play/stop/next/previous.
------------------------------------------------------------
If you like this project click on our website google ads !
------------------------------------------------------------
Contributor credits ( Thanks ):
-TuXXX (Damien Thébault) from PCInpact community
-The #pcinpact-linux IRC chan on teepi.net
-Marseillai from #kubuntu-fr ( Cyril Breuil ) for packaging jukebox3D on (xu)(ku)(u)buntu.

Changelog:

0.5.0
- jukebox3D has been rewritten from scratch, the code is clean and more thread safe.
- A cover engine has been added, is based on the cool works "gmpc_cover_art", by the way, now if the album cover is
not available in your audio player,jukebox3D can now directly download the cover from the internet.
- MPD support added ( mpc needed ).
- Rhythmbox support is fixed.
- jukebox3D can now be start without the main gui, you only just have to add the --nogui argument, like jukebox3D --nogui.
- The internal audio toolbar is now skinable.
- Devil dependancy has been removed to SDL-image, but if you really want to use libdevil instead of SDL
 you can look into include/main.h, uncomment //#define EspUseDevil and comment #define EspUseSDL.
- Archive mode don't show anymore the 'generic' cover in listened album.
- New 'generic' album picture based from a tango icon. 
- Bundled themes, jukebox3D have now pre-installed themes.

0.4.0
- Theme engine, you can export your theme,import new theme or save the current theme!
- Add theme repository on j3d.linuxonfire.org/themes/.
- You can move now the player toolbar.
- Options window is now more homogeneous and clear (restarting from scratch).
- Corrected MakeFile.
- Detecting if GL_ARB_texture_non_power_of_two is available, for avoid segfaulting with Mesa driver.

0.3.0
- Starting support of exaile multimedia player.
- Now jukebox3D support .desktop standard and is installed like other apps.
- Listened album can be moved with your mouse now, like current playing.
- Reflections is fully managed for each objects.
- New option menu.
- OpenGL stack management for object selection (managing simultaneous object on stack for priority).
- Add zooming+bleeding effect when player toolbar is clicked.

0.2.0
- Adding manage displaying listened album.
- Text alignment can be modified ( left, right, center ).
- Space between informations line can be modified.
- New default settings ( some of them can be modified ).
- New icons settings for toolbar. 
- New model for current playing: AudioCD box.
- Speed and rotation is fixed.
- Playing informations can now be displayed only at the start of a track.
- Current playing and archive can be scaled.

0.1.0:
- Initial public release

Known bug:
- Compiz seem to have some behaviors with GTKGLEXT in full screen with nvidia driver.

Coming next ( 0.5.0 to 1.0.0 ):
- xscreensaver integration, for automatically start jukebox3D.
- Picture support for the quad background.
- Enhance effect between album/song change.
- mpd support (need mpd users).

