MediaMVP Server - 0.0.4
=======================

Licensing
---------

The mediamvp server is licensed under the GNU Public License - see the file
COPYING in the root directory.

Installation
------------

- Setting up the MediaMVP to boot without the windows server

* You should obtain the file dongle.bin from build 21317 or later. This can be 
obtained from either the Hardware/ directory if you've installed the software,
or by unzipping the installer.

* You need a dhcp/bootp server and tftp server

* Place the dongle.bin in an appropriate place under the tftpd root - eg 
/tftpboot/dongle.bin

* Edit your dhcpd configuration file so that it provides a non-dynamic ip
address to the MediaMVP. You can find out the MAC address by doing a arp -a.
Chances are it starts off with 00:0d:fe..

* Specify a filename in the dhcpd.conf file, this should be dongle.bin, thus
your entry in dhcpd.conf should look similar to this:

        host mvp {
                filename "dongle.bin";
                hardware ethernet  00:0d:fe:XX:XX:XX;
                fixed-address [dotted ip adddress];
        }

- Building the MediaMVP server program

* You need to install libevent from http://www.monkey.org/~provos/libevent/ 
libevent is used only as an easy replacement for select()

* You should then be able to type "make" and the server should build (only
tested at present under Linux - OS X may need <stdint.h> included by the
mediamvp.h file)

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

- General Configuration

* The file mediamvp.conf is the main configuration file, you should only
need to change one option which is main:interface at the top of the file,
change this to be the ip address of the machine you plan to run the server
on.

- Media Configuration

* The files "livetv" and "liveradio" contain redirectors for the various
live TV and radio stations that are exported by the streamdev plugin on
your vdr box. The supplied config contains all (English) UK channels, though
you may want to change the host referenced in the URL (unless your vdr
box is named florence as well!)

* liveradio may also contain redirectors to internet radio stations that 
broadcast in mp3 format.

Tips
----

* You can change TV channels using the up and down keys
* Change settings using Vol+/Vol- OK uses the selected configuration
* You can use a dongle.bin earlier than 21307 by uncommenting the option
  olddongle in the mediamvp.conf file

Issues
------

* Interface is a little clunky in places
* Only streaming TV and radio are supported.
* Aspect ratio is probably slightly broken - the image size is hardcoded
at present.
* Settings can only be previewed - saving will be enabled soon (done 0.0.3)
* If you switch radio stations then you have to press "OK" twice (fixed 0.0.3)
* Multiple MVPs should be supported, but it hasn't been tested...
* A fair bit of debug information is spat out onto stdout.

Future
------

* Support for playback of non-streaming mp3/mpeg files
* Support for saving of settings (done 0.0.3)
* Interface improvements
* Retrieval of scheduling information from vdr for channel selection screens
* Full integration into vdr as a plugin

Greater Future
--------------

* Abandon this server and run vdr on the MVP itself (assuming some technical
details come out)

Contact
-------

Any crashes (with stack traces) should be sent to dom@suborbital.org.uk

Enjoy,

d.

