Statistics
| Branch: | Tag: | Revision:

dvbd / dvbd.html @ 904d298f

History | View | Annotate | Download (5.04 KB)

1
<!doctype html public '-//W3C//DTD HTML 4.01//EN' 'http://www.w3.org/TR/html4/strict.dtd'>
2
<html>
3
<head>
4
<title>dvbd</title>
5
<link rel="stylesheet" href="dvbd.css" type="text/css">
6
</head>
7

    
8
<body>
9

    
10
<div id="sourceforgelogo">
11
<a href="http://sourceforge.net">
12
<img src="http://sourceforge.net/sflogo.php?group_id=98000&amp;type=5" 
13
     width="210" height="62" border="0" alt="SourceForge.net Logo" />
14
</a>
15
</div>
16

    
17
<h1>dvbd</h1>
18

    
19
<h2>Introduction</h2>
20

    
21
<p>
22
The idea behind dvbd is to make maximum use of your DVB card by
23
allowing multiple channels on the same frequency to be tuned. It is
24
split into a daemon (dvbd) and client programs (dvbcat, dvbsched,
25
dvblist).  It is possible to associate a priority with a connection to
26
the daemon, so that (depending on the given priority) the tuner can be
27
made available by dropping connections of inferior priority.
28
</p>
29

    
30
<p>
31
A web frontend to dvbsched, called dvbdguide, is included to facilitate the scheduling
32
of dvbd recording activities. Please note this requires an 
33
<a href="http://www.xmltv.org">XMLTV</a> datafeed. Check out
34
<a href="http://www.doc.ic.ac.uk/~jak97/dvbdguide/tv.html">a captured dvbdguide page</a>.
35
</p>
36

    
37
<p>
38
<a href="http://sourceforge.net">SourceForge</a> are kindly hosting
39
this project. Here are the important links:
40
<ul>
41
<li><a href="http://sourceforge.net/projects/dvbd">Project Home Page</a></li>
42
<li><a href="http://sourceforge.net/project/showfiles.php?group_id=98000">Downloads</a></li>
43
<li><a href="http://sourceforge.net/cvs/?group_id=98000">CVS</a></li>
44
</ul>
45
</p>
46

    
47
<h2>News</h2>
48

    
49
<ul>
50
<li>2004/10/14 Simon makes Fedora Core 2 RPMs for 0.7.5.</li>
51
<li>2004/04/25 Encouraging initial reports on DVB-C support.</li>
52
<li>2004/04/17 Working on cable (DVB-C) support with help from Marcus Willberg.</li>
53
<li>2004/02/17 Tobias Eckert has contributes initial satellite (DVB-S) support.</li>
54
</ul>
55

    
56
<h2>Configuration</h2>
57

    
58
<p>
59
The daemon has a configuration file which by default is
60
/etc/dvbd/config. The format of the file is lines of key=value. Line
61
comments can be begun with #.
62
</p>
63

    
64
<p>
65
The following configuration fields are available:
66

    
67
<dl>
68
<dt>socket</dt>
69
<dd>the (unix) socket to listen on. Default is /var/run/dvbd/dvbd.socket </dd>
70

    
71
<dt>socket-uid</dt>
72
<dd>the user id of the socket file. The default user id is that same as the user id of the process
73
running dvbd. If you user this option, dvbd probably need to run as root.</dd>
74

    
75
<dt>socket-gid</dt>
76
<dd>the group id of the socket file. The default user id is that same as the user id of the process
77
running dvbd. If you user this option, dvbd probably need to run as root.</dd>
78

    
79
<dt>socket-mode</dt>
80
<dd>the mode (in octal) of the socket file. The default is to create the socket with umask of 007</dd>
81

    
82
<dt>pid</dt>
83
<dd>the pid file to write to once it has become a daemon. Default is /var/run/dvbd/dvbd.pid </dd>
84

    
85
<dt>log</dt>
86
<dd>the log file to write to. Default is /var/log/dvbd.log</dd>
87

    
88
<dt>schedule</dt>
89
<dd>the schedule file to write to. Default is /var/spool/dvbd/schedule</dd>
90

    
91
<dt>debug</dt>
92
<dd>the debug level (default is 0) If a higher debug level is set, dvbd will not go into the
93
background.</dd>
94

    
95
<dt>numcards</dt>
96
<dd>the number of DVB cards your system supports</dd>
97

    
98
<dt>card0</dt>
99
<dd> the first DVB card. The format of this field is type:frontend:channels Where 
100
 <ul>
101
  <li>type may be one of dvb-t, dvb-s or dvb-t.</li>
102
  <li>frontend is the path to the frontend (tuner) for the card</li>
103
  <li>channels is the path to the tzap/szap/czap format channels.conf file for the card.</li>
104
 </ul>
105
If no cards are specified, a default of one dvb-t card is assumed with
106
channels file /etc/tzap.channels.conf and frontend
107
/dev/dvb/adapter0/frontend0
108
</dd>
109
</dl>
110

    
111
</p>
112

    
113
<h2>Client Programs</h2>
114

    
115
<p>
116
At the moment there are three client programs. dvbcat, dvblist and dvbsched.
117
dvbcat can be used to extract a stream from the dvbd for live TV.
118
</p>
119

    
120
<p>
121
For example:
122
</p>
123

    
124
<pre>
125
$ dvbcat dvb-t "BBC ONE" | mplayer -
126
</pre>
127

    
128
<p>
129
dvbsched is used to schedule a recording. Note that an output file
130
must be specified whose containing directory must be owned by the user
131
issuing the request. The directory must also be writable by the dvbd
132
program.
133
</p>
134

    
135
<p>
136
The time format is in at(1) format. See at's manpage for more
137
information about it.
138
</p>
139

    
140
<p>
141
For example:
142
</p>
143

    
144
<pre>
145
$ mkdir /tmp/recordings
146
$ dvbsched dvb-t "ITV 2" 19.20 32 /tmp/recordings/itv2.mpg
147
</pre>
148

    
149
<p>
150
If there is a clash the program will ask you if you want
151
to cancel your job.
152
</p>
153

    
154
<p>
155
dvblist shows the channels available to tune at the given 
156
priority (default is 10). 
157
</p>
158

    
159
<p>
160
For example:
161
</p>
162

    
163
<pre>
164
$ dvblist dvb-t
165
</pre>
166

    
167
<p>
168
If there are some existing connections the list of channels
169
may be shorter than the full list. 
170
</p>
171

    
172
<h2>Contributing And Comments</h2>
173

    
174
<p>
175
Feedback, bug fixes, new features, patches and suggestions are very
176
welcome.  Please send to: jak (change the at to @ and the dot to .) at users dot sourceforge dot net or post on the
177
SourceForge project page.
178
</p>
179

    
180
<h2>Other DVB Resources</h2>
181

    
182
<ul>
183
<li><a href="http://www.linuxlinks.com/portal/cgi-bin/search.cgi?query=dvb">LinuxLinks</a></li>
184
</ul>
185

    
186
</body>
187
</html>