From TV-Viewer
Jump to: navigation, search


Distribution specific informations may be available in the howto section


In order to install and use the program you'll need:

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.

If you want to (or not want to) install one of this features use the switch

--enable-FEATURE=ARG (e.g. --enable-tktray=yes || --enable-tktray=no)

with the configure.tcl script.


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


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.


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.

Personal tools