
FIXME: v4lctl needs to be setuid?
FIXME: should use /tmp rather than cwd?
FIXME: better error reporting in image.cgi
FIXME: add new graphics
FIXME: add 'change to channel' option

Webbased Sky/Sky+ remote control software - linux version
=========================================================

Installation
============

1. Ensure you have apache and perl installed.

You probably will anyway, if you don't refer to your linux distribution's
documentation.

2. Check you have xawtv installed (in particular the 'v4lctl' program).

This is used to grab an image from the TV card.

3. Check you have 'netpbm' installed (particular the 'ppmtojpeg' program).

This is used to turn the grabbed image into a jpeg.

4. Install the cmdline-linux package & confirm controller is working

Follow the readme.txt in the cmdlinux-linux package (available from the
same website as this package), and make sure you can send digits to your
connected sky box.

eg:

"sky-control-usb 0C00" (to send a '0' to a sky+ box on output 1)

Check you can see the '0' appear when you view the sky+ box output on a TV.

4. Install cgi scripts

Usually this will be a case of (from the directory that you have the software
unpacked too):

cp * /usr/lib/cgi-bin/
cp remote.jpg /var/www/
chmod a+rx /usr/lib/cgi-bin/* /var/www/*
(above 3 commands should be run as the 'root' user)

Configuration
=============

At the top of controls.cgi, there are several configuration options.

skyplus: set this to zero if you're not using a sky+
boxoutput: set this to 1 or 2 depending which output the box you want to control is connected to
delay: you may want to increase this if you sky box is slower and the screengrab is taken too early a lot

Using it
========

Firstly, make sure that your TV card is tuned to the sky/sky+ channel.

Then, check that the image capture is working by visiting:

http://127.0.0.1/cgi-bin/image.cgi

You should see a frame grab from the sky box.

Then try the full cgi:

http://127.0.0.1/cgi-bin/controls.cgi

You should see a sky remote control on the right, and an image from the TV card on the left. Clicking on the
buttons on the remote should cause the image on the left to update.

-- 
Copyright (C) Joseph Heenan 2005
joseph@heenan.me.uk
