ReplaySix version 0.3

Description:

ReplaySix is a "thin" client for networked ReplayTV and DVArchive machines
( www.dvarchive.org ).  It downloads the show database either directly 
from each ReplayTV, or it can the entire network database from a single
PC running DVArchive.

The program displays 3 spin controls to select one of the recordings.
The top spin control selects the ReplayTV (or DVA) unit the program is
stored on.  The second spin control selects the Category the program is
stored under.  Finally the third spin control selects the program within
that category.  The details of the selected program are displayed at the
bottom of the screen.

Once the desired program is selected, press the "Play" button on the
remote, or navigate down to select the on-screen "Play" button.
ReplaySix will then exit, and will launch the CinemaSix player
( www.up.org/cinemasix/ ) - a special beta version which can stream
ReplayTV files direct from the ReplayTV is bundled with ReplaySix - to
actually play the file.

New to version 0.3 is the addition of forward/backwards skipping in the
CinemaSix program.  The navigation keys:
  East: forward 30 sec
  West: reverse 15 sec
  North: forward 1 minute
  South: reverse 1 minute
  Forward: forward 5 minutes
  Back: reverse 5 minutes

Restrictions:

Currently the show details are limited, and the navigation is restrictive,
but it allows you to select and play ReplayTV files using only the Roku
remote control.  The CinemaSix player may have lipsync issues as well.
Hint: Press the "rotate" button after playback starts, or after using
one of the navigation function, to improve the lipsync.

DVArchive support is limited to version 3.0 and higher.

Installation:

Just extract the .zip file somewhere that your Roku can find it (either
a flash card or a network directory).  You will need to define what the
IP address of the DVArchive machine is.  This is done by adding a 
single line to the end of /etc/hosts as follows:
--add-to-etc-hosts-------------
192.168.0.3     dvarchive
-------------------------------
Alternatively, beginning with version 0.2, ReplaySix now supports directly 
downloading the guide information from individual ReplayTVs.  To do this,
edit the ReplaySix.roku shell script, and include the IP address(es) of the
ReplayTV and/or DVArchive machines (optionally followed by :port to select 
the port number as well) for the REPLAYLIST variable.  Be sure to remove the
comment ( # ) character from the beginning of one, and only one, of the 
REPLAYLIST lines.

The default IP address is the "dvarchive" name lookup from the /etc/hosts
file, and the default port is 8042, which is the default used by DVArchive.

Tip: If you put the IP address / name mapping in your /etc/hosts file,
then you can use more meaningful names in the REPLAYLIST assignment, and
these names will be shown in the application.

Tip: The direct support doesn't list categories, is slower to start up,
and doesn't automatically detect new ReplayTVs or changed IP addresses.
So, if you have (or can easily get) a DVArchive machine running, the 
ReplaySix program works better getting listings of all of your ReplayTV
units (and also all DVArchive units) from a single DVArchive machine.

Troubleshooting:

If you run into problems, or it doesn't find any ReplayTV units, you can
look at the log generated in /tmp/ReplaySix.log, or run the program from
a command prompt using the ReplaySix.cmd script.  Also, error messages will
be displayed in red at the top of the screen, under the "ReplaySix" logo.

The URL passed to the CinemaSix media player is stored in 
/tmp/ReplaySix.url.  If you are out of space in the /tmp filesystem, then
CinemaSix will fail to launch with the selected program.

You can also manually run the program like this to see the log info:

	./ReplaySix.cmd 192.168.0.11 192.168.0.12

where the numbers after ReplaySix.cmd are the IP addresses of your ReplayTV,
or the IP address of a DVArchive machine.  You should then see a bunch of 
info displayed on the console window, or at least some form of error message.

The DVArchive connection is done on port 8042, because this is the special 
"Video Server" port that it uses.  For this to work you must have the 
"streaming server" option enabled in the DVArchive program, on (the default)
port 8042.  This is configured on the bottom of the "Server" configuration 
tab in DVArchive.  The special port 8042 will give out information about all 
ReplayTV units that DVArchive knows about.  If you have changed the port
number in DVArchive, then you can use the IPADDRESS:PORT on the ReplaySix
command line to specify which port to use.

DVArchive also emulates a ReplayTV "Server" on port 80, but on that port it 
only gives out the listings local to that particular DVArchive machine, and 
not for the full network.

I should also say that I have only tested with version 3.0 of DVArchive.  
With that version, the first time you attempt to connect to a DVArchive
machine you will get a 10-second timeout before it connects.  Also 
you must have the "UPnP" support enabled in DVArchive for it to work.  
It does not appear to work with DVArchive 2.1.

Source:

The source code is included, under the GNU GPL:

 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free
 * Software Foundation; either version 2 of the License, or (at your option)
 * any later version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

