Zapper (1.0)

This plugin runs any specified command whenever Windows Media Center attempts to change channel.

The plugin is forked from Dan Glass's plugin for controlling DirectTV with MCE,
which is available at: http://blog.dan.netidentity.com/blog/_archives/2004/10/24/165904.html 
The fork was done by Rhubarb (rover.rhubarb@gmail.com).
The default configuration and instructions of this version have been changed by
Joseph Heenan to make them suitable for the Dusky Control sky controllers.


Requirements: 
* Windows XP MCE 2004 or 2005 
* .NET Framework v1.1 

Install:

* Unzip the zip file into any directory.

  - There's no installer - this is your final installation directory.

  - If you move it later, make sure that zapper.config is in the same directory as the
    zapper.dll.

* Install the Dusky Control command line tools for windows from:
  http://www.dusky-control.com/software.shtml
  
  The sky-control.exe should be extracted to c:\. (You can put it elsewhere, but
  you will need to change zapper.config if you do so.)
  
* Edit zapper.config:

  - The default settings assume the sky-control command line tool is installed as above,
    and that a sky (not Sky+ or Sky+HD) box is connected to the first output of the sky
    controller.

  - Zapper will take the specified Executable and run it with the specified CommandLineArgs,
    but only after it has replaced the text specified in ChannelPlaceholder with the actual
    channel number that Media Center is changing to.

  - Make sure you don't have any un-escaped special XML characters in the config file.
    For example if you use <channel> as a placeholder, the utility will just bomb.

  - Make sure the log file has a full path, and that all backslashes in paths are escaped, 

  - Later you can double-check that your command line is correct by looking in the log file.
    All channel change commands are logged.

* Run reg.bat 

* Reboot (or shut down the windows services, and kill all processes starting with eh*) 

* If it fails, check the log file for details.

* Note that Zapper (and the DirectTV plugin it's based on) get the channel change events
  directly from Media Center, independently of any settings you may have chosen for your
  STB. So, for example, even if you specified that your STB requires 3 digits for changing
  the channel, followed by the Enter button, Media Center will still only send out the 
  string "32" for changing to channel 32, not 032, not 032Enter. If you need to pad (as I
  do) the you do that in Girder or whatever command you are running with Zapper.

Uninstall:
* Run unreg.bat
* Reboot (or shut down the windows services, and kill all processes starting with eh*) 

Thanks again to Dan Glass for doing all the hard work in the DirectTV plugin that
made this all, not only possible, but easy - and thanks to Rhubarb for doing the
zapper fork.


Joseph Heenan
joseph@dusky-control.com



