MAS(R): The Media Application Server(TM) 
        (public release 0.6.2) INSTALL


This file describes installation steps to get MAS running. See the
accompanying README file for general instructions and background
information.

The MAS Core, Developer Tools, and Control Applications in this
release are distributed in separate tar files, mas-0.6.2.tar.gz,
mas-devtools-0.6.2.tar.gz and mas-control-apps-0.6.2.tar.gz
respectively.

The mp1a_mad codec is released under the GNU General Public License and is
distributed separately as mas-codec_mp1a_mad-0.6.2.tar.gz.

The MAS controller is distributed separately as
mas-controller-0.6.2.tar.gz.

Note:

The tar files above will unpack into a new directory mas-0.6.2/. If
you untar all of them from within the same directory (i.e., your home
directory), you will create a consistent source tree.


PREPARATIONS
============

MAS is configured with imake. Our configuration is derived from
X.org's X11R6.5 but does not include imake. 

MAS is configured to build on the following platforms:

    Solaris (SPARC and x86)
    Linux with gcc-2.x and glibc2 

On any other platform, you will have to hand edit the Imakefiles, or
make changes in config/.

If your platform is not one of those named above, there is a good
chance a sound driver plugin for your platform is not available. You
need such a driver plugin if you want to make sound with MAS. If you
write one yourself, use an existing one as a template.

Currently, we have no means to auto-detect the presence of certain
libraries on your system. Therefore, you need to edit the imake
configuration file before compiling. These are the decisions:

  A) Using GUIs:
  --------------
  
  All our GUIs use the X Window System and the GTK libraries. To use
  the MAS client applications that have GUIs (see README for a list)
  you need the GTK libraries installed (version 2.x).
  
  In config/host.def, you will find an entry named "HasGtk2", which is
  set to YES by default. If you do not have Gtk installed or do not wish
  to build the GUI clients, change this to NO.
  
  
  B) Using mp3 playback 
  ---------------------
  
  For mp3 decoding, the masplayer client currently uses a codec device
  which links against the GPLed MAD (MPEG audio decoder) library. We
  highly recommend installing this library and the codec device on the
  machines you want to use as a target of mp3 playback.

  The codec is available separately in the file
  mas-codec_mp1a_mad-0.6.2.tar.gz.
  
  The MAD library is best obtained from   
  http://www.underbit.com/products/mad/
  (source code: ftp://ftp.mars.org/pub/mpeg/mad-0.14.2b.tar.gz)
  
  If you decide not to use mp3 playback, edit config/host.def to say
  NO for HasMAD.
  
  
  C) Spectrum Display (optional)
  ------------------------------
  
  FFTW (the fastest fourier transform in the west) is used to
  calculate a frequency spectrum in the visual device. Use of this
  device in the demo clients is by default disabled, so you probably
  don't need to bother installing it.
  
  If you have FFTW already, you can edit config/host.def to say YES
  for HasFFTW. Compiling the masconf_gui and massignal clients with
  -DUSE_VISUAL will then result in a window that looks like some
  graphical EQ.

  

BUILDING:
=========

After the above preparations, perform the following commands in the
top level MAS directory:

> imake -I./config
> make World

(The ">" indicates a command prompt.)



INSTALLING:
===========

By default, MAS installs to /usr/local/mas. It uses the /tmp and
/var/tmp filesystems to store state information, to log errors, and
for sockets. Examples:

/usr/local/mas/bin	 server and client binaries
/usr/local/mas/lib	 server and client libraries
/usr/local/mas/lib/mas   plugin devices and interfaces
/tmp/.MAS-unix           unix domain sockets
/var/tmp/mas	         state and timing information

If you want to change the prefix, edit the file config/site.def,
changing the following line:

#define ProjectRoot /usr/local/mas

Next, enter (possibly as root)

> make install

Congratulations. MAS is now installed. 

If you wish to install the MAD codec device, do so now as described in
its README file.
