MythRokuPlayer2 provides a framework to easily emit xml schema compatible
with the original private channel (http://forums.roku.com/viewtopic.php?f=28&t=33704#p214457)
for access to MythTV Videos and Recordings as well as additional services (eg. Weather info) 
which are easily integrated using the class system.  

***   This software is provided AS-IS without warranty or liability, either expressed or implied.   ***


PREREQUISITS
-functioning mythtv backend and mythweb
-ffmpeg or alternates mythffmpeg,handbrakecli (for converting recordings to H.264 format)
-Mythtv video are stored in H.264 format (mp4)
-web user (eg. apache) permission to delete recordings
-php-gd
-php-xml
-php-pdo
-PHP ActiveRecord, in a php included location   (see http://www.phpactiverecord.org, and Testing below)
-$MythBackendPort (default 6544) is open to the webserver process so that myth backend services can be called.

INSTALLATION
There are two parts to the MythRokuPlayer2: The Brightscript UI code which is the Roku channel, 
and the PHP code which handles requests from the Roku.  Initial installation then requires
placing mythroku and its files in your mythweb directory.  The mythroku directory can be a 
symlink to MythRokuPlayer/mythroku so you can extract a zip or clone the code right in your
mythweb directory.

    [mythweb]$ git clone https://github.com/rshendershot/MythRokuPlayer.git
    [mythweb]$ ln -s MythRokuPlayer/mythroku
    
To finish the install, adjust your installation to your environment as in the following steps:    

1) You can use the private MythRokuPlayer channel, but if you wish to customize
	the player User Interface BrighScript code then you must "side-load" a
	development version.  
	
	If you use the private channel (http://owner.roku.com/Account/ChannelCode/?code=YWWMH) 
	then you can skip to #2
	
	you can set up your Roku box in developer mode to install the dev channel.
	Use remote and enter Home 3x, Up 2x, Right, Left, Right, Left, Right
	Note: permission denied failure may occur if SD microcard is present. Remove it.
	
	Make note of the IP and the password (firmware asof 5.2) that you set!
	
	add the following to your .bashrc file "ROKU_DEV_TARGET=roku.ip" 
	Where roku.ip is the ip address of your Roku player.
	
	for Roku box with 5.2 or later firmware a side-load requires authentication.
	add ROKU_DEV_PASSWORD=roku.passwd to your environment

2) you need to modify mythweb to enable streaming of mp4 files.
 	modify /usr/share/mythtv/mythweb/includes/utils.php by adding the 
	following around line 247
	
	   case 'mp4' : return "$url.mp4";
	
   and in the following file /usr/share/mythtv/mythweb/modules/stream/stream_raw.pl
	add an additonal elseif in the file type section 

        elsif ($basename =~ /\.mp4$/) {
            $type = 'video/mp4';
            $suffix = '.mp4';
    	}
	
	if you are using authentication to protect your mythweb (best practice)
	you need to add the following to your mythweb.conf file (near the top)
	
	<LocationMatch .*/mythroku*>
        	Allow from 192.168.1.0
    	</LocationMatch>


3) add the mythroku directory to your mythweb directory and change the permission
	to that of your webserver. Give write permissions to mythroku/cache.
	
	Ensure that the .htaccess file is in that directory as well. 
	The .htaccess file in the mythroku directory simply has:

	   RewriteEngine off

	This is to stop mythweb adding its templates to the xml data.

	You need to edit the settings.php file with your local parameters for example
	ip or url of your webserver.

    Your web server process (apache, www-data, etc.) will need write permissions within
    your Recordings storage area.  Mythtv owns the recording and its MP4, as well as 
    preview (PNG) files, but the web server is the process that deletes all of that. 

4) convert recordings from mpg to mp4
	create a user job in mythtv (mythbackend setup-> general-> Job Queue)
	add the following to a job command

	/pathtomythweb/mythroku/rokuencode.sh "%DIR%" "%FILE%"
	
	to make it a default job run after every recording. In your mythconverge->setting
	set the AutoRunUserJob1 (or whichever job you set it to) data = 1
	
	This will automatically encode a recording to mp4 format which can then be
	streamed by roku.  It will also update mythconverg.recorded.basename with MP4 extension
	(the player ignores other filetypes).  Note that mythweb and mythtv frontend will thereafter
	use the MP4 not the original.  
	
5) Testing 
    Using either a command line or your browser, load the testing file
        php mythtv_all_xml.php
    or the initial file that the Roku player uses
        php mythtv.php
    (in a browser just point to your webserver/mythweb/mythroku/theFile.php and view source)
    
    mythtv.php provides the initial categories and mythtv_all_xml.php gets a listing
    of the recordings and videos that would be sent to the Roku.      
    
    You can get a human-readable form of the sd/hd Img or  streamUrl by adding it as a 
    parameter.  
        php mythtv_all_xml.php [img url || stream url]
    
    You can also enter img or stream url from the XML directly into your web browser 
    and monitor your web server error log as there is additional logging information.
    
    A simple shortcut to installing PHP-ActiveRecord is to extract the latest daily 
    directly in your mythroku directory.  Rename php-activerecord_yyyymmdd to php-activerecord
    if necessary so that you have
        
        mythweb/mythroku/php-activerecord/ActiveRecord.php    

6) The player
    if you have modified the UI code, sideload install MythRokuPlayer to your roku:
    	in the MythRokuPlayer directory (containing this read me) simply type
    	
    	   make && make install

    Or install the original private channel;
    
    On the Roku you should have a MythTV (original) or MythTV 2 channel (sideloaded)
    channel.  Start it and point it to your web server and its path to mythroku

	eg. http//192.168.1.10/mythweb/mythroku

7) Debuging (only if you've sideloaded as in #6)
	
	telnet $ROKU_DEV_TARGET 8085

	will give you any output from the player for debug

	You may need to comment out the following line
	bind-address = 127.0.0.1 in /etc/my.cnf to allow access to mysql

        
Good luck and happy streaming.