CinemaSix Media Player v1.1 Beta
================================

CinemaSix is a Media Player for the Roku HD1000.  It supports a number
of playback formats and playback sources:
 - Mpeg2 Transport Streams (Plays ATSC-compliant streams)
 - Mpeg2 Program Streams (Plays files up 10Mbps including DVD ".VOB" files
    that have already been decrypted (See errata below about lip sync)
 - Will play either TS or PS streams via HTTP or UDP.   These streams
    can be generated third-party programs such as VideoLan (VLC).
    HTTP streaming is usually reliable up to ATSC bitrates, UDP is
    unreliable over a few of Megabits per second

CinemaSix will NOT play MPEG 1 content.

CinemaSix can change aspect ratios and programs within streams.  Press INFO
on your remote control (see below)

The most reliable way to play streams wrt to lip sync is to stream them over
    HTTP from VLC or tsreader.


INSTALL
=======

- Unzip the contents of the distribution zipfile into a directory
    that is accessible to your Roku HD 1000 or onto a compact flash
    that you will plug into your HD1000.
- Reboot your HD1000
- You should see the CinemaSix application
- You can run CinemaSix from the command line and pass it an URL or Filename.
    If you're doing this, run the "CinemaSix.cmd" binary.


REMOTE CONTROL
==============

The following remote control buttons work:

 - EXIT will quit playback
 - PAUSE will pause / resume playback
 - INFO will pull up a menu that controls functions like Aspect, Program
    Selection.  Use the UP/DOWN Nav to select the function you want to adjust.
    Use the RIGHT/LEFT Nav to select the setting on the spinner.
 - ROTATE will attempt to re-establish lipsync.  From time to time, lip sync is
    lost and ROTATE can often fix it (See Errata below).


ERRATA
======

 - Lipsync on program streams still messes up often, especially with
    AC3.  When this happens try ROTATE
 - User interface and Exit are REALLY slow when playing higher bitrate streams.
	Will be fixed in a future release
 - Still crashes sometimes and crashes the decoder sometimes.  You'll find a 
	nice easter egg, if you're lucky enough to crash the decoder :-)
 - Sometimes CinemaSix does not exit cleanly and requires you to reboot
	the HD1000
 - Lots more!


NETWORK STREAMING
=================

- HTTP Streaming is compatible with VideoLAN (vlc) and tsreader
- Use "udp:port" for your URL to enable incoming UDP streaming.
    This is VLC compatible, but only reliable up to a few Mbps


ADVANCED
========

 - Lipsync sometimes gets better if you turn off digital output in the Roku
    HD1000 setup.  If you're really adventurous, you can try to remove 
    the #define DONT_REINTERLEAVE_PES at the top of PESExtractor.cpp and
    recompile CinemaSix


** Still a beta release **
** Proceed at own risk, may cause damage, may set HD1000 on fire **

If you have problems, please use the Roku Technical mailing list for support:
   roku-tech@lists.rokulabs.com


/*
 * Copyright (c) 2004, Sujal Patel
 * All rights reserved.
 * 
 * CinemaSix comes with ABSOLUTELY NO WARRANTY
 * This is free software, and you are welcome to redistribute it
 * under the terms of the GNU General Public License
 * See COPYING for license and terms and conditions
 * 
 */


Sujal Patel (smpatel@up.org)
