Documentation:dev:installation

Distribution specific informations may be available in the howto section

Requirements
In order to install and use the program you'll need:
 * Tcl and Tk >= 8.5
 * sqlite3 and sqlite3 Tcl bindings
 * ivtv-tune and v4l2-ctl (ivtv-utils).
 * Mplayer >= 1.0rc2 (A most recent version of mplayer is recommended)
 * xdg-utils

It is recommended to install,


 * tkimg (If you use Tcl/Tk < 8.6)

as well.

Optional Features
TV-Viewer comes with some optional features. You may choose if you want them to be installed or not.


 * tktray - A Tk library to dock Tk applications to the system tray (default: enabled)
 * Depends on glibc; libxdmcp; libxau; libxcb; libx11
 * These dependencies should be installed by default on every linux distribution.


 * tclkit - Install TV-Viewer using a tclkit. (default: disabled)
 * A tclkit provides a complete TCL/TK environment. You may use this if your distribution does not ship an appropriate version of Tcl/Tk. Download the tclkit from tv-viewer.sourceforge.net and place it in extensions/tclkit/

Use the following switch if you want to enable or disable one of these features

--enable-FEATURE=ARG (e.g. --enable-tktray=yes/no ; --enable-tclkit=yes/no)

with the configure.tcl script.

Installation
Installing TV-Viewer is done by 2 commands. First of all you need to configure your build environment and afterwards install the files to your hard disk.

$ ./configure.tcl (configures build environment and creates install.tcl) % ./install.tcl (you may need root privileges)

For more configuration details run $ ./configure.tcl --help

If there are any errors during installation, check your build environment and the file "./config.log". Otherwise contact us

NOTE

The installer will overwrite previously installed files. If you used the package manager of your distribution to install TV-Viewer make sure you deinstall this package first. It might be better to generally uninstall the old version first. Users updating from version 0.7.7 must use the installer of this version to unistall TV-Viewer before updating.

Uninstall
You can uninstall TV-Viewer with the installation script. This will delete all program files but your configuration will still be present ("~/.tv-viewer/").

% ./install.tcl --uninstal

Supported hardware
Basically all devices that are supported by the ivtv, cx18, pvrusb2 and cx88-blackbird drivers, should work with TV-Viewer.

Here is a list of devices that were reported as working:
 * Hauppauge WinTV PVR 150
 * Hauppauge WinTV PVR 250
 * Hauppauge WinTV PVR 350
 * Hauppauge WinTV PVR 500
 * Hauppauge WinTV PVR USB2
 * Hauppauge HVR-1900 (analogue)
 * Hauppauge HVR-1950 (analogue)
 * Hauppauge HVR-1600
 * AcerTV MCE 116 Plus
 * Sundtek MediaTV Pro

If you're using a different device together with TV-Viewer please contact us or add a howto.