
         -----------------------------------------
           MusicBox.app (A GNUstep music manager)
         -----------------------------------------

Introduction
------------

MusicBox.app is a GNUstep music manager (and player). 

It can play many audio format, but only OGG format is officially supported.
And it can play CD and use Freedb both via cddbp and http. 
It can also encode your favorite songs.

It use several bundles/libraries for flexibility: Mixer, Cddb and ShengGuang.

Install
-------

See INSTALL for more details

libMusicBox
----------------------

Several protocols and classes are supported in libMusicBox:

- AudioModule: Manager the play list from different media,
               ex. audio CD, a directory, even MP3 player.
               They are the subclass of user-defined play list (AudioList)
               Therefore, subclass the AudioList class to make a new one.

- PrefModule: For preference. The same interface as GNUMail.
              Use the PreferencesModule.h.

- EncoderModule: For encoding. The default one use cdda2wav and oggenc.
                 Use the EncoderModule.h.

There is a ModuleLoader classes in libMusicBox,
which is used to load these module easily.

License
-------
ShengGuang library is covered under the GNU Lesser General Public License.
MusicBox, Mixer, and Cddb are covered under the GNU General Public License.
See COPYING and COPYING.LIB for more details.

Note: ShengGuang/SGContentViewer is covered under GNU Public License 
      due to the code is modified from GWorkspace.
      But it is only a demo bundle, which use ShengGuang 
      and is not part of the ShengGuang library.
      It is not installed by default.

Acknowledgements
----------------
Thank Nicolas Roard for the design of interface.
Thank the authors of GNUMail and Affiche as excellent reference for this project.

Author
------
Yen-Ju Chen <yjchenx@hotmail.com>

