KMTTG WINDOWS INSTALLATION INSTRUCTIONS

1. INSTALL 32 BIT JAVA IF NEEDED

Kmttg is now written in Java (originally used Perl) and supports Java 1.5 or later. You can download Java Runtime Environment (JRE) from here:

http://java.com/en/download/manual.jsp

NOTE: If you are on a 64 bit system you should still install the 32 bit version of Java. kmttg is compiled with 32 bit version to remain compatible with 32 bit systems.

2. DOWNLOAD KMTTG INSTALLATION ZIP FILE

Download kmttg installation zip file from:

http://code.google.com/p/kmttg/downloads/list

• kmttg_vxxx.zip file – This contains the platform independent kmttg installation files
• v0p6a or later are Java versions. Versions prior to that were Perl based and should no longer be used.

3. UNPACK ZIP FILE

• Unpack kmttg_vxxx.zip file to your desired location. In this example: c:\kmttg

NOTE: You must have write access to this folder that contains kmttg.jar since kmttg tries to write configuration file to same folder. Hence for Windows7/Vista you should generally NOT install under c:\Program Files or c:\Program Files (x86) as they have locked down write permissions that may prevent proper file writing.

NOTE: Do NOT browse into the kmttg_vxxx.zip file and launch kmttg.jar from there. Even though that will start kmttg GUI there are other files and folders that are needed for a complete install. Therefore you should make sure to unzip the file fully first and then launch kmttg.jar from that location.

UPGRADE INSTALLATION TIPS

• If upgrading from a previous Java kmttg installation you can normally unzip over the previous installation. That way you can preserve the kmttg configuration and avoid having to re-configure. NOTE: In some cases there are other files and folders aside from kmttg.jar updated as part of a release, so you should unzip the zip file over the top of your previous installation to make sure you overwrite all files that make up an installation. When unzipping instruct Windows to overwrite previous files. If you want to install to same location and make sure to get a clean new installation then remove everything except *.ini files. That way you get a full new installation but preserve all your previous settings.
• For some releases the 3rd party tools are also updated. To force kmttg to download and install the accompanying 3rd party tools simply remove the tivodecode folder. Then when you start kmttg GUI allow it to download and install the tools package (it will overwrite the files in current installation).

NOTE: If you have older version of kmttg service running you should shut down the service first and then unpack zip file over existing installation. If you don't do so then certain files cannot be overridden and hence installation will fail.

NOTE: If you are installing to a new location and use kmttg service then make sure you remove the kmttg service and install it again using the new kmttg installation otherwise you will still be running older version.

4. STARTING KMTTG

Simply double click on kmttg.jar file (c:\kmttg\kmttg.jar in this example) of the installation to start the program. You can also create a shortcut to that file if you wish to make it easier: Simply browse to kmttg.jar file and then right click on it and choose Copy, then right click mouse over empty desktop space and choose Paste Shortcut. Now when you double-click on that desktop shortcut it will launch the kmttg GUI.

NOTE: If double-clicking on kmttg.jar file does nothing then you don't have proper jar file association setup. Either re-install Java or do the following to set the proper association. First determine full path to your Java installation javaw.exe file. Then start a cmd window as administrator and type:

• assoc .jar=jarfile
• ftype jarfile="C:\Program Files (x86)\Java\jre6\bin\javaw.exe" -jar "%1" %*

(Of course replace path to javaw.exe above with your installation path.)

• The first time launch you will be prompted to allow kmttg to download and install required tools. Choose Yes and wait for the download and installation to complete.
• Also the first time you launch kmttg you will be prompted for your 10 digit Media Access Key (MAK) which is needed to download & decrypt programs from your Tivos.

NOTE: kmttg may detect Tivos on your network before you have a chance to enter the 10 digit MAK, and will not be able to get listings for detected Tivos without MAK, so after entering MAK you will need to click on Refresh List button for each Tivo to get listings.

• You will probably want to further configure kmttg after installation. Consult the configuring_kmttg wiki page for details.

RUNNING JAR FILES AS ADMINISTRATOR

If for some reason you need to run kmttg.jar as administrator you will need to locate the path to javaw.exe and then right click on the file and set properties to run as administrator.