LinuxTV dvb-apps

The LinuxTV dvb-apps package contains some Linux DVB API applications and a set of utilities that both the developer and end user alike will find quite useful. Specifically, the utilities are geared towards the initial setup, testing, and operation of a DVB device, whether it be of the software decoding (a.k.a. 'budget') or hardware decoding (a.k.a. 'premium' or 'full-featured') class.

Obtaining the dvb-apps package

The dvb-apps package source code is available from the LinuxTV website and can be retrieved via Mercurial (Hg) or by downloading a tarball, compressed in either tar.bz2 or tar.gz format. (Note: The build procedure is very simple -- (a) uncompress the download (not required if you pulled the sources with Hg); (b) in a command shell, cd to the top directory level of the sources; (c) run 'make' and then 'sudo make install').

Alternatively, if the package is maintained in a repository available for your "distro", then you can obtain a pre-built version with your package manager. Note, however, that not all Linux distributions ('distro's') refer to the package by the proper "dvb-apps" name. The Debian package name for it, for example, is "dvb-utils". In other cases, you may also sometimes see it called "dvbtools". This is an unfortunate situation, as it introduces an element of confusion; additional to the fact that DVB tools is itself the name of another project (not associated with LinuxTV) that features its own set of DVB related utilities. In any regard, the following provides a few examples with common distros

• To install it on a debian etch system:

# apt-get install dvb-utils

• To install it on a debian lenny system:

# apt-get install dvb-apps

• With gentoo:

# emerge linuxtv-dvb-apps

• Using Fedora, assume root privileges then install the dvb utilities with:

# yum install dvb-apps

• Using Fedora, assume root privileges then install the dvb utilities with:

# zypper install dvb

List of utilities within 'dvb-apps'

The README file in the top level of the package gives a brief description of the package's contents, but in general, some of the items of interest that you will find are in the:

/test directory

• diseqc: Sends various diseqc sequences on a SAT frontend.
• set22k: Legacy tone switching for SAT frontends.
• setvoltage: Legacy voltage switching for SAT frontends.
• setpid: Set video and audio PIDs in the demux (only for hardware MPEG decoder)
• video: tiny video watching application
• test_sections: Hex dump of section data from stream.
• test_sec_ne: Like test_sections, but also test Not-Equal filter mode.
• test_pes: Hex dump of PES data from stream.
• test_tt: Demonstrate teletext decoding from PES data.
• test_av: Test audio and video MPEG decoder API.
• test_vevent: Test VIDEO_GET_EVENT and poll() for video events
• test_stc: Test DMX_GET_STC.
• test_stillimage: Display single iframes as stillimages
• test_dvr: Record a partial transport stream of selected PIDs to a file or a full stream if supported by the hardware

/util directory

• loadkeys: a utility to setup IR control keymaps using /proc/av7110_ir interface
• dvbdate: read date time information from the currently tuned multiplex
• dvbnet: DVB network interface manager (IP over DVB)
• dvbtraffic: PID analysis of currently tuned multiplex
• scan: the original frequency scanning tool used to generate channel lists
• dvbscan: another frequency scanning tool used to generate channel lists .... some distro package managers have rebranded this as "scandvb" ... also note that "atscscan", if included, is simply a copy of dvbscan
• azap, czap, szap, tzap: tuning utilities for DVB.
• femon: monitor frontend status
• gnutv: simple ;-) DVB UI
• dib3000-watch:
• dst_test:

Links

• See "Testing your DVB device" for usage examples of some of these tools.