MediaMVP Server Installation
============================


Building
--------

Please read the file INSTALL.general and ensure that you have all the 
prerequisites.

* If you have ImageMagick libraries then uncomment the HAVE_MAGICK at
  the top of mediamvp/config.mak. Set MAGICK_VERSION to either 5 or 6
  depending on what version of ImageMagick you have

* If you have libjpeg then uncomment the HAVE_LIBJPEG line at the top of
  mediamvp/config.mak

* If you have libxml2 then uncomment the HAVE_LIBXML2 line at the top of
  mediamvp/config.mak

* Enter the mediamvp/console directory and type make. A binary called
  "mediamvp" should be produced


Configuration
-------------

The server is usually configured by use of a configuration file. This file
is in a windows .ini style format, an example file is supplied in
console/mediamvp.conf. A full list of configuration options can
be found by running:

mediamvp -h

Columns are:

1. Short option for use on the command line
2. Long option for use on the command line or in the configuration file
3. Type
4. Default value


* Running mode configuration
----------------------------

-c --main:configdirectory    (string)    Current directory

Directory where all configuration files can be found

-f --main:config-file        (string)    mediamvp.conf

Filename of the configuration file, this can either be an absolute location
or be in the directory defined by the -c option above

-d --main:daemon             (bool)      FALSE

Run server as a daemon

   --main:pidfilename        (string)    /var/pid/mediamvp.pid

File to place pid into - useful for init.d style scripts

-u --main:user               (string)    [Current user]

User to run program as - the server can drop privileges after it has
bound to the listen ports.

   --main:debuglevel         (integer)   2

Debug level for server (0 = most, 3 = least)

   --main:logfilename        (string)    [stdout]

File to output debug info to


* Port Configuration
--------------------

The server will always listen on UDP port 16881 for service queries, however
the other ports used can configured

   --main:interface          (string)    [hostname]

IP address of interface to listen on - use only if your computer cannot 
resolve its hostname correctly

   --main:streamport         (integer)   6337

Port to listen on for media connections
   --main:guiport            (integer)   5906

Port to listen on for gui connections


* MediaMVP configuration
------------------------

   --main:dongleversion      (integer)   21323

Dongle version to be compatible with - this should match the dongle.bin
version that you are using otherwise weird things will happen!

   --main:width              (integer)   640

Width of the MVP gui - this value is appropriate for PAL, it will need to
be changed for NTSC.

   --main:depth              (integer)   480

Height of the MVP gui - this value is appropriate for PAL, it will need to
be changed for NTSC.

   --main:screenwidth        (integer)   720

Total width of the MVP display - this value is appropriate for PAL, it will 
need to be changed for NTSC.

   --main:screendepth        (integer)   576

Total depth of the MVP display - this value is appropriate for PAL, it will 
need to be changed for NTSC.

   --main:screensaver        (bool)      FALSE

Enable the onboard screensaver

* Mediafile location
--------------------

   --media:livetv            (string)    [None]

Name of the livetv file - see console/livetv for an example

   --media:liveradio         (string)    [None]
 
Name of the HTTP radio file - see console/liveradio for an example

   --media:mp3               (str array) [None]

Directories to search for music files

   --media:mpeg              (str array) [None]

Directories to search for video files

   --media:pictures          (str array) [None]

Directories to search for picture files

   --media:rss               (string)    [None]

Name of the file containing RSS entries - see console/newsfeed for an example


* Advanced configuration
------------------------

   --main:mpegbufsize        (integer)   200000

Amount of prebuffering for video files

   --main:mp3bufsize         (integer)   4000

Amount of prebuffering for audio files

   --gui:font                (string)    [Built in default]

Name of the fontfile to use

   --media:switchstandard    (boolean)   FALSE

Switch standards if framerate of the mpeg file requires it










