linux_installation

KMTTG LINUX INSTALLATION

1. INSTALL JAVA 8 OR LATER IF NEEDED

Kmttg is written in Java and latest versions requires Oracle Java version 1.8.0_40 or later. You can download Java Runtime Environment (JRE) from here:

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

IMPORTANT: Java versions earlier that 1.8.0_40 will NOT work
NOTE: Java OpenJDK that comes standard with Linux distributions do not include JavaFX so will not work. You need to download and install Oracle version of Java 8-10 instead which does include JavaFX. Note that starting with Java 11, Oracle distribution does not include JavaFX automatically either.

2. DOWNLOAD KMTTG INSTALLATION ZIP FILE

Download kmttg current platform independent installation zip file from Files area:
http://sourceforge.net/projects/kmttg/files/?source=navbar

• kmttg_vxxx.zip file – This contains the platform independent kmttg installation files

3. UNPACK ZIP FILE

• Unpack kmttg_vxxx.zip file to your desired location. In this example: /home/moyekj/kmttg

UPGRADE INSTALLATION TIPS (Version v1p0a or later)

• Starting with version v1p0a you can now update kmttg installation to latest official version automatically using Help-Update kmttg... menu entry. kmttg will check your installed version against the latest available official version and prompt to update if they are different.

UPGRADE INSTALLATION TIPS (older versions of kmttg)

• 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 be sure to let system 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.

STARTING KMTTG

• Run the kmttg script in the installation folder to start kmttg (in this example /home/moyekj/kmttg/kmttg).
• The first time launch you will be prompted for your 10 digit Media Access Key (MAK) which is needed to download & decrypt programs from your Tivos. If you already have a ~/.tivodecode_mak file containing the MAK number then kmttg will automatically read it from there.
  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 button for each Tivo to get listings.
• kmttg uses "which" to try and determine the location of the various 3rd party tools. If you don't have them in your PATH then you will need to manually specify the locations of the tools if you have them.
• You will probably need to further configure kmttg after installation. Consult the [configuring_kmttg] wiki page for details.

TIVODECODE WITH MPEG2 TRANSPORT STREAM SUPPORT

If you have a TiVo series 4 or later or a TiVo in New Zealand or Australia be sure to use an updated version of tivodecode that has support for TiVo files in mpeg2 Transport Stream container.

You can get the source code from here:
https://github.com/wmcbrine/tivodecode-ng

Building from source on linux is very simple:

./configure
make

USING WINE TO RUN WINDOWS ONLY TOOLS

Some tools used by kmttg only run on Windows platform, however can be made to run on Linux platform using wine (tool to run Windows binaries on Linux platform). As an example, the following t2extract script can be made to run Windows T2Sami t2extract (used for creating captions files):

• Create following script called t2extract:

  #! /bin/sh
  wine "C:\Program Files\T2Sami\t2extract.exe" -f srt -p `dirname "$3"` "$3" "$4" "$5" "$6" "$7" "$8" "$9"

• Make it executable:

  chmod +x t2extract

• Under kmttg config enter full path to the script as t2extract executable.

[b_s]

Wine notes do not explain how to get C:\Program Files\T2Sami\t2extract.exe into ~/.wine/drive_c/Program Files

[Bill Wesson]

FolloException: java.lang.NoClassDefFoundError thrown from the UncaughtExceptionHandler in thread "main"
Shutdown hook executing

Exception: java.lang.NoClassDefFoundError thrown from the UncaughtExceptionHandler in thread "Thread-0"
wed the steps for installing java, and unzipping kmttg files. When I ran ./kmttg I get the following error:

What have I missed?

Running on Lenovo Thinkpad W530, Centos 7; kernel; 3.10.0-862.11.6.el7.x86_64, 24 GB memory.