Wktivoguide for Windows

This document explains how to run Wktivoguide under Windows, and the changes you'll need to make to the original instructions that were written for Unix. It was tested on Windows XP, but it should be similar on other versions as well.

Before Getting Started

Please read the entire Wktivoguide README file for Unix first, before reading this document.

Important: if you plan to use Wktivoguide to create your own guide data for your TiVo, then you will not be able to use the slices generated on the OzTiVo Emulator. This is because the numbers in the ``Files\numbers'' file, once used, cannot be reused. The OzTiVo Emulator keeps its own set of numbers, and it is impossible to keep these numbers in sync with your numbers.

Install Perl

I recommend using the free package from ActiveState:

• Go to http://www.activestate.com/Products/ActivePerl/ and click the Download button in the upper left.
• Enter your details, or just click Next to skip this step.
• Download the latest version (currently 5.8.3 build 809) as a Windows ``MSI'' file. (12MB)
• Run the MSI file to begin the installation wizard. Just keep clicking ``Next'' and install it with the default options unless you know what you're doing.
• You can check that Perl is installed ok by opening a Command Prompt (or DOS) window and typing ``perl -v'' and it should display its version number.

• The HTTP::Lite module:

  • Go to http://search.cpan.org/~rhooper/. Under the heading ``Distribution'', click the link for the latest version (currently ``HTTP-Lite-2.1.6'').
  • Then click the ``Browse'' link to display a list of files. Download only the file ``Lite.pm'', and save it to the directory ``C:\Perl\site\lib\HTTP'' (assuming you installed Perl to the default directory)
  • Optionally, you can also download ``test.pl'' and save it to any directory. Then open a Command Prompt (or DOS) window, change to the directory where you saved the file, and type ``test.pl'' to run several tests on the module. The default options should work fine unless you use a web proxy.
• The CGI::Enurl module:

  • Go to the directory ``C:\Perl\site\lib'' on your hard drive. Create a subdirectory there called ``CGI'';.
  • Go to url{http://search.cpan.org/jenda/}. Under the heading ``Distribution'', click the link for the latest version (currently ``CGI-Enurl-1.07'').
  • Then click the "Browse" link to display a list of files. Download only the file "Enurl.pm", and save it to the directory "C:\Perl\site\lib\CGI".
  • Optionally, you can also download "test.pl" and save it to any directory. Then open a Command Prompt (or DOS) window, change to the directory where you saved the file, and type "test.pl" to run several tests on the module.

Install Wktivoguide

• Unpack the zip file to a new directory, being sure to keep the original folder structure in the zip file.
• Double-click the file "install.pl". This creates 4 subdirectories: "Data", "Data2", "Webfiles", and "Temp".
• Edit the file ".guiderc" with an editor such as Notepad.

  • Check the NoNag setting, as described in the Unix document.
  • Check the Tempdir setting and set it for Windows ("Tempdir = ./Temp").

Run Wktivoguide

Running the scripts under Windows is essentially the same as the Unix version, except that the "doit" script is called "doit.pl", and has been changed slightly. If you just double-click the file, it defaults to the same as "doit.pl all", which runs all 4 scripts as described in the Unix document. This is basically the whole enchilada, and will create a slice file for all entries in "Files\websources", and will take a very long time (probably a few hours). You can shorten this time significantly by skipping the "search" step, which does genre lookups. But you'll probably want these, especially if you have Tivo Suggestions enabled. Otherwise you can run each script individually, as described in the Unix document (ex. "doit.pl fetch"). The full usage for "doit.pl" is:

Usage: doit.pl [-n] [-c configfile] [ < Command > ] 
   -n: stops writing of numbers in the make phase 
   -c: use 'configfile' instead of default '.guiderc'  
   Command is one of the following (default = 'all'):  
      fetch: gets the web pages 
      search: searches yahoo for unknown genres  
      add: augments the intermediate data  
      make: makes the slice file  
      both: does the fetch and make phases 
      all: does all four phases

Load the Slice File

Optionally, backup your Tivo. The easiest way to do this is to move the hard drive to a PC and then use an MFS Tools boot CD to backup the entire drive to an image file on the PC. See the Hinsdale HowTo guide for more info: http://www.newreleasesvideo.com/hinsdale-how-to/index9.html. Copy the file "output.slice" to your Tivo (usually via FTP in binary mode). Run the following commands:

• dbload30.tcl output.slice
• fixup30.tcl
• touch /var/timestamp

Good luck!

Initial creation by Russell Gilbert on 25 March, 2004. Edited by Warren Toomey, March 2004.