dvbv5-zap(1)			 User Commands			  dvbv5-zap(1)

NAME
       dvbv5-zap - DVBv5 tool for service tuning

SYNOPSIS
       dvbv5-zap [OPTION]... channel-name

       dvbv5-zap [OPTION]... frequency-name (for monitor or all PIDs mode)

DESCRIPTION
       dvbv5-zap is a command line tuning tool for digital TV services that is
       compliant with version 5 of the DVB API, and backward compatible with
       the older v3 DVB API.

       dvbv5-zap uses by default a new channel/service file format that it is
       capable of supporting all types of Digital TV standards. It can also
       support the legacy format used by the legacy dvb-apps.

       The dvbv5-zap tool can be used on several different modes, depending on
       the parameters used.

       Please note that, in order to be able to use it in record mode, where
       both the audio and video Packet IDs (PIDs) are output to a dvr record
       node, the input file should contain the PIDs, e. g. they should have
       been produced by a digital TV zap application like dvbv5-zap.

OPTIONS
       -c, --channels= channel-name-file
	      Read channels list from 'file'.  Defaults to
	      ~/.tzap/channels.conf.

       -3, --dvbv3
	      Force dvbv5-zap to use DVBv3 only.  Useful to test if the legacy
	      API support is working.

       -a, --adapter=adapter#
	      Use the given adapter. Default value: 0.

       -A, --audio_pid=audio_pid#
	      Select a different audio Packet ID (PID).	 The default is to use
	      the first audio PID found at the channel-name-file.

       -C, --cc=country_code
	      Set the default country to be used by the MPEG-TS parsers, in
	      ISO 3166-1 two letter code. If not specified, the default
	      charset is guessed from the locale environment variables.

       -d, --demux=demux#
	      Use the given demux. Default value: 0.

       -f, --frontend=frontend#
	      Use the given frontend. Default value: 0.

       -I, --input-format=format
	      Format of the input file. Please notice that caps is ignored. It
	      can be:

	      channel	      - for dvb-apps compatible channel file;

	      zap	      - for dvb-apps compatible zap file;

	      dvbv5 (default) - for the dvbv5 apps format.

       -l, --lnbf=LNBf_type
	      Type of LNBf to use 'help' lists the available ones.

       -L, --search=string
	      Search/look for a string inside the traffic.  Used only on
	      monitor mode.

       -m, --monitor
	      Enable monitor mode. On this mode, it will monitor de DVB
	      traffic for all Packet IDs (PIDs) received by the device,
	      showing the Packet IDs (optionally filtered by a string), and
	      presenting some traffic statistics: number of packets per
	      second, number of Kbytes per second and total traffic.  Those
	      statistics are shown per PID and the total per MPEG-TS.

       -o, --output=file
	      Output filename. If specified, it will output the content of the
	      MPEG-TS into the file with the first video PID and the first
	      audio PID (or the one specified by audio_pid#).  Use -o - for
	      directing the output to stdout.

       -p, --pat
	      Add PAT and PMT MPEG-TS tables to TS recording (implies -r).

       -P, --all-pids
	      Don't filter any pids. Instead, outputs all of them.

       -r, --record
	      Sets up the /dev/dvb/adapteradapter#/dvr0 for MPEG-TS record.

       -s, --silence
	      Increases silence (can be used more than once).

       -S, --sat_number=satellite_number
	      Satellite number.	 Used only on satellite delivery systems.  If
	      not specified, disable DISEqC satellite switch.

       -t, --timeout=seconds
	      Amount of seconds to keep the tool running for zapping and for
	      recording.  Useful if you want to record a program that you know
	      its duration.

       -U, --freq_bpf=frequency
	      SCR/Unicable band-pass filter frequency to use, in kHz.  Used
	      only on satellite delivery systems.

       -v, --verbose
	      Be verbose. Useful to check if the MPEG-TS is happenning fine.
	      This option can be used multiple times to increase verbosity.

       -V, --video_pid=video_pid#
	      video pid program to use (default 0)

       -w, --lna=LNA
	      Enable, disable or put LNA power in auto mode. Not all frontends
	      support it.  Valid values are:

	       0 - disable

	       1 - enable

	      -1 - auto

       -W, --wait=time
	      Adds additional wait time for DISEqC command completion.

       -x, --exit
	      Exit after tuning.

       -X, --low_traffic
	      Also shows DVB traffic with less than 1 packet per second.  Used
	      only in monitor mode.

       -?, --help
	      Outputs the usage help.

       --usage
	      Gives a short usage message.

       --version
	      Prints program version.

EXIT STATUS
       On success, it returns 0.

EXAMPLES

   Recording a channel
       The typical use is to tune into a channel and put it into record mode:

       $ dvbv5-zap -c dvb_channel.conf 'music' -r
       using demux '/dev/dvb/adapter0/demux0'
       reading channels from file 'dvb_channel.conf'
       service has pid type 05: 204
       tuning to 573000000 Hz
       audio pid 104
       dvb_set_pesfilter 104
       Lock (0x1f) Quality= Good Signal= 100.00% C/N= -13.80dB UCB= 70 postBER= 3.14x10^-3 PER= 0
       DVR interface '/dev/dvb/adapter0/dvr0' can now be opened

       The channel can be watched by playing the contents of the DVR
       interface, with some player that recognizes the MPEG-TS format.

       For example, this audio-only channel can be played with mplayer:

       $ mplayer -cache 800 /dev/dvb/adapter0/dvr0
       MPlayer SVN-r37077-4.8.2 (C) 2000-2014 MPlayer Team
       TS file format detected.
       NO VIDEO! AUDIO MPA(pid=104) NO SUBS (yet)!  PROGRAM N. 0
       ==================================================================
       Opening audio decoder: [mpg123] MPEG 1.0/2.0/2.5 layers I, II, III
       AUDIO: 48000 Hz, 2 ch, s16le, 192.0 kbit/12.50% (ratio: 24000->192000)
       Selected audio codec: [mpg123] afm: mpg123 (MPEG 1.0/2.0/2.5 layers I, II, III)
       ==================================================================
       AO: [alsa] 48000Hz 2ch s16le (2 bytes per sample)
       Video: no video
       Starting playback...

   Monitoring a channel
       The dvbv5-zap tool can also be used to monitor a DVB channel:

       $ dvbv5-zap -c dvb_channel.conf 573000000 -m
       using demux '/dev/dvb/adapter0/demux0'
       reading channels from file 'dvb_channel.conf'
       service has pid type 05:	 204
       tuning to 573000000 Hz
       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= -13.90dB UCB= 384 postBER= 96.8x10^-6 PER= 0
	 dvb_set_pesfilter to 0x2000

       PID     FREQ    SPEED   TOTAL
       0000    9.88 p/s	       14.5 Kbps       1 KB
       0001    1.98 p/s	       2.9 Kbps	       376 B
       0010    18.77 p/s       27.6 Kbps       3 KB
       0011    48.42 p/s       71.1 Kbps       8 KB
       0012    1455.53 p/s     2137.8 Kbps     270 KB
       …
       1fff    1033.60 p/s     1518.1 Kbps     192 KB
       TOT     25296.44 p/s    37154.2 Kbps    4700 KB

       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= -13.90dB UCB= 384 postBER= 96.8x10^-6 PER= 0

BUGS
       Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>

COPYRIGHT
       Copyright (c) 2011-2014 by Mauro Carvalho Chehab.

       License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

DVBv5 Utils 1.30.1		Fri Oct 3 2014			  dvbv5-zap(1)