-
Notifications
You must be signed in to change notification settings - Fork 3
/
tv_grab_dvb.1
79 lines (79 loc) · 2.9 KB
/
tv_grab_dvb.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
.\" Hey, EMACS: -*- nroff -*-
.TH TV_GRAB_DVB 1 "2007-08-22"
.\" Please adjust this date whenever revising the manpage.
.SH NAME
tv_grab_dvb \- Grab TV listings for DVB EIT data.
.SH SYNOPSIS
.B tv_grab_dvb
.RI [ options ]
.BI \-f \ file
.br
.B tv_grab_dvb
.RI [ options ]
.BI > \ file
.SH DESCRIPTION
This manual page documents briefly the
.B tv_grab_dvb
command.
After tuning your DVB tuner to a multiplex using \fBczap\fP, \fBszap\fP, \fBtzap\fP or any other tuning programm, \fBtv_grab_dvb\fP can be used to convert the data from the Event Information Table (EIT) into an xmltv listing.
.SH OPTIONS
A summary of options is included below.
.TP
.BI \-i\ path
Read data from \fIpath\fP instead of \fB/dev/dvb/adapter0/demux0\fP.
\fIpath\fP might specify an alternative demultiplexer device node or a file,
which contains captured EIT data.
\fB\-\fP is interpreted as stdin.
.TP
.BI \-f\ file
Write output to \fIfile\fP instead of stdout.
.TP
.BI \-t\ timeout
Overwrite the \fItimeout\fP in seconds, after which \fBtv_grab_dvb\fP exits, if no new data arrives that long.
.TP
.BI \-o\ offset
Additional offset in hours from \fB\-12\fP to \fB12\fP to add to any time stamp.
.TP
.B \-c
Use channel identifiers from the file \fBchanidents\fP instead of \fIsidnumber\fP\fB.dvb.guide\fP.
.TP
.B \-d
Show all shows, even when their start-date is before yesterday or after two weeks from now.
.TP
.B \-n
Show only shows on now or later, but not before.
.TP
.B \-m
Show only shows on now or later of the currently tuned multiplex.
.TP
.B \-p
Show only shows on now or later of other multiplexes than the currently tuned one.
.TP
.B \-s
Silent mode, disables status output of received packets and shows.
.TP
.B \-u
Allow output of updated info, disables filtering out duplicate shows.
Might result in multiple entries for a show.
.TP
.BI \-e\ encoding
Overwrite default character encoding used instead of \fBISO6937\fP.
DVB supports multiple character encodings.
But many stations seem to think, that \fBISO8859\-1\fP is used when no explicit encoding is given.
Since this is not so, the default character encoding can be changed to any encoding listed by \fBiconv \-l\fP.
.SH BUGS
Rule number one:
It's the fault of your broadcast station.
The information transmitted varies greatly and there is no simple way to extract useful information from many stations data.
\fBtv_grab_dvb\fP can't create data from thin air and text parsing becomes very ugly very fast.
Please bear this in mind when you start complaining.
.PP
If \fBtv_grab_dvb\fP segfaults or reports an error, please try to capture some data using \fBdvbsnoop \-s sec 18 \-b \-n 200 > file\fP, until you're able to reproduce the bug using \fBtv_grab_dvb \-i file \-o /dev/null\fP.
Than please send us that file.
.SH SEE ALSO
.BR xmltv (3pm),
.BR czap (1),
.BR szap (1),
.BR tzap (1).
.SH AUTHOR
tv_grab_dvb was written by Mark Bryars and Philipp Hahn <pmhahn BEI debian org>.