1dvbv5-zap(1)                     User Commands                    dvbv5-zap(1)
2
3
4

NAME

6       dvbv5-zap - DVBv5 tool for service tuning
7

SYNOPSIS

9       dvbv5-zap [OPTION]... channel-name
10
11       dvbv5-zap [OPTION]... frequency-name (for monitor or all PIDs mode)
12

DESCRIPTION

14       dvbv5-zap is a command line tuning tool for digital TV services that is
15       compliant with version 5 of the DVB API, and backward  compatible  with
16       the older v3 DVB API.
17
18       dvbv5-zap  uses by default a new channel/service file format that it is
19       capable of supporting all types of Digital TV standards.  It  can  also
20       support the legacy format used by the legacy dvb-apps.
21
22       The dvbv5-zap tool can be used on several different modes, depending on
23       the parameters used.
24
25       Please note that, in order to be able to use it in record  mode,  where
26       both  the  audio and video Packet IDs (PIDs) are output to a dvr record
27       node, the input file should contain the PIDs, e. g.  they  should  have
28       been produced by a digital TV zap application like dvbv5-zap.
29

OPTIONS

31       -c, --channels= channel-name-file
32              Read  channels  list  from  'file'.   Defaults  to ~/.tzap/chan‐
33              nels.conf.
34
35       -3, --dvbv3
36              Force dvbv5-zap to use DVBv3 only.  Useful to test if the legacy
37              API support is working.
38
39       -a, --adapter=adapter#
40              Use the given adapter. Default value: 0.
41
42       -A, --audio_pid=audio_pid#
43              Select a different audio Packet ID (PID).  The default is to use
44              the first audio PID found at the channel-name-file.
45
46       -C, --cc=country_code
47              Set the default country to be used by the  MPEG-TS  parsers,  in
48              ISO  3166-1  two  letter  code.  If  not  specified, the default
49              charset is guessed from the locale environment variables.
50
51       -d, --demux=demux#
52              Use the given demux. Default value: 0.
53
54       -f, --frontend=frontend#
55              Use the given frontend. Default value: 0.
56
57       -I, --input-format=format
58              Format of the input file. Please notice that caps is ignored. It
59              can be:
60
61              channel         - for dvb-apps compatible channel file;
62
63              zap             - for dvb-apps compatible zap file;
64
65              dvbv5 (default) - for the dvbv5 apps format.
66
67       -l, --lnbf=LNBf_type
68              Type of LNBf to use 'help' lists the available ones.
69
70       -L, --search=string
71              Search/look for a string inside the traffic.  Used only on moni‐
72              tor mode.
73
74       -m, --monitor
75              Enable monitor mode. On this mode, it will monitor de DVB  traf‐
76              fic  for  all  Packet IDs (PIDs) received by the device, showing
77              the Packet IDs (optionally filtered by a string), and presenting
78              some traffic statistics: number of packets per second, number of
79              Kbytes per second and total traffic.  Those statistics are shown
80              per PID and the total per MPEG-TS.
81
82       -o, --output=file
83              Output filename. If specified, it will output the content of the
84              MPEG-TS into the file with the first video  PID  and  the  first
85              audio  PID  (or  the one specified by audio_pid#).  Use -o - for
86              directing the output to stdout.
87
88       -p, --pat
89              Add PAT and PMT MPEG-TS tables to TS recording (implies -r).
90
91       -P, --all-pids
92              Don't filter any pids. Instead, outputs all of them.
93
94       -r, --record
95              Sets up the /dev/dvb/adapteradapter#/dvr0 for MPEG-TS record.
96
97       -s, --silence
98              Increases silence (can be used more than once).
99
100       -S, --sat_number=satellite_number
101              Satellite number.  Used only on satellite delivery systems.   If
102              not specified, disable DISEqC satellite switch.
103
104       -t, --timeout=seconds
105              Amount  of  seconds to keep the tool running for zapping and for
106              recording.  Useful if you want to record a program that you know
107              its duration.
108
109       -U, --freq_bpf=frequency
110              SCR/Unicable  band-pass  filter  frequency to use, in kHz.  Used
111              only on satellite delivery systems.
112
113       -v, --verbose
114              Be verbose. Useful to check if the MPEG-TS is  happenning  fine.
115              This option can be used multiple times to increase verbosity.
116
117       -V, --video_pid=video_pid#
118              video pid program to use (default 0)
119
120       -w, --lna=LNA
121              Enable, disable or put LNA power in auto mode. Not all frontends
122              support it.  Valid values are:
123
124               0 - disable
125
126               1 - enable
127
128              -1 - auto
129
130       -W, --wait=time
131              Adds additional wait time for DISEqC command completion.
132
133       -x, --exit
134              Exit after tuning.
135
136       -X, --low_traffic
137              Also shows DVB traffic with less than 1 packet per second.  Used
138              only in monitor mode.
139
140       -?, --help
141              Outputs the usage help.
142
143       --usage
144              Gives a short usage message.
145
146       --version
147              Prints program version.
148

EXIT STATUS

150       On success, it returns 0.
151

EXAMPLES

153   Recording a channel
154       The typical use is to tune into a channel and put it into record mode:
155
156       $ dvbv5-zap -c dvb_channel.conf 'music' -r
157       using demux '/dev/dvb/adapter0/demux0'
158       reading channels from file 'dvb_channel.conf'
159       service has pid type 05: 204
160       tuning to 573000000 Hz
161       audio pid 104
162       dvb_set_pesfilter 104
163       Lock (0x1f) Quality= Good Signal= 100.00% C/N= -13.80dB UCB= 70 postBER= 3.14x10^-3 PER= 0
164       DVR interface '/dev/dvb/adapter0/dvr0' can now be opened
165
166       The  channel  can  be watched by playing the contents of the DVR inter‐
167       face, with some player that recognizes the MPEG-TS format.
168
169       For example, this audio-only channel can be played with mplayer:
170
171       $ mplayer -cache 800 /dev/dvb/adapter0/dvr0
172       MPlayer SVN-r37077-4.8.2 (C) 2000-2014 MPlayer Team
173       TS file format detected.
174       NO VIDEO! AUDIO MPA(pid=104) NO SUBS (yet)!  PROGRAM N. 0
175       ==================================================================
176       Opening audio decoder: [mpg123] MPEG 1.0/2.0/2.5 layers I, II, III
177       AUDIO: 48000 Hz, 2 ch, s16le, 192.0 kbit/12.50% (ratio: 24000->192000)
178       Selected audio codec: [mpg123] afm: mpg123 (MPEG 1.0/2.0/2.5 layers I, II, III)
179       ==================================================================
180       AO: [alsa] 48000Hz 2ch s16le (2 bytes per sample)
181       Video: no video
182       Starting playback...
183
184   Monitoring a channel
185       The dvbv5-zap tool can also be used to monitor a DVB channel:
186
187       $ dvbv5-zap -c dvb_channel.conf 573000000 -m
188       using demux '/dev/dvb/adapter0/demux0'
189       reading channels from file 'dvb_channel.conf'
190       service has pid type 05:  204
191       tuning to 573000000 Hz
192       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= -13.90dB UCB= 384 postBER= 96.8x10^-6 PER= 0
193         dvb_set_pesfilter to 0x2000
194
195       PID     FREQ    SPEED   TOTAL
196       0000    9.88 p/s        14.5 Kbps       1 KB
197       0001    1.98 p/s        2.9 Kbps        376 B
198       0010    18.77 p/s       27.6 Kbps       3 KB
199       0011    48.42 p/s       71.1 Kbps       8 KB
200       0012    1455.53 p/s     2137.8 Kbps     270 KB
201
202       1fff    1033.60 p/s     1518.1 Kbps     192 KB
203       TOT     25296.44 p/s    37154.2 Kbps    4700 KB
204
205       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= -13.90dB UCB= 384 postBER= 96.8x10^-6 PER= 0
206

BUGS

208       Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>
209
211       Copyright (c) 2011-2014 by Mauro Carvalho Chehab.
212
213       License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
214       This is free software: you are free  to  change  and  redistribute  it.
215       There is NO WARRANTY, to the extent permitted by law.
216
217
218
219DVBv5 Utils 1.18.0              Fri Oct 3 2014                    dvbv5-zap(1)
Impressum