Statistics
| Branch: | Tag: | Revision:

dvbd / dvbd.html @ bfdb7446

History | View | Annotate | Download (3.92 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 (dvbclient, dvblist).
25
It is possible to associate a priority with a connection to the
26
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 href="http://sourceforge.net">SourceForge</a> are kindly hosting
32
this project. Here are the important links:
33
<ul>
34
<li><a href="http://sourceforge.net/projects/dvbd">Project Home Page</a></li>
35
<li><a href="http://sourceforge.net/project/showfiles.php?group_id=98000">Downloads</a></li>
36
<li><a href="http://sourceforge.net/cvs/?group_id=98000">CVS</a></li>
37
</ul>
38
</p>
39

    
40
<p>
41
NB, at the moment only DVB-T is supported (that's the type of DVB that
42
I have), but it should be fairly easy to add support for DVB-S and
43
DVB-C.
44
</p>
45

    
46
<h2>Configuration</h2>
47

    
48
<p>
49
The daemon has a configuration file which by default is
50
/etc/dvbd/config. The format of the file is lines of key=value. Line
51
comments can be begun with #.
52
</p>
53

    
54
<p>
55
The following configuration fields are available:
56

    
57
<dl>
58
<dt>socket</dt>
59
<dd>the (unix) socket to listen on. Default is /var/run/dvbd/dvbd.socket </dd>
60

    
61
<dt>pid</dt>
62
<dd>the pid file to write to once it has become a daemon. Default is /var/run/dvbd/dvbd.pid </dd>
63

    
64
<dt>log</dt>
65
<dd>the log file to write to. Default is /var/log/dvbd.log</dd>
66

    
67
<dt>schedule</dt>
68
<dd>the schedule file to write to. Default is /var/spool/dvbd/schedule</dd>
69

    
70
<dt>debug</dt>
71
<dd>the debug level (default is 0) If a higher debug level is set, dvbd will not go into the
72
background.</dd>
73

    
74
<dt>numcards</dt>
75
<dd>the number of DVB cards your system supports</dd>
76

    
77
<dt>card0</dt>
78
<dd> the first DVB card. The format of this field is type:frontend:channels Where 
79
 <ul>
80
  <li>type may be one of dvb-t, dvb-s or dvb-t.</li>
81
  <li>frontend is the path to the frontend (tuner) for the card</li>
82
  <li>channels is the path to the tzap/szap/czap format channels.conf file for the card.</li>
83
 </ul>
84
If no cards are specified, a default of one dvb-t card is assumed with
85
channels file /etc/tzap.channels.conf and frontend
86
/dev/dvb/adapter0/frontend0
87
</dd>
88
</dl>
89

    
90
</p>
91

    
92
<h2>Client Programs</h2>
93

    
94
<p>
95
At the moment there are three client programs. dvbcat, dvblist and dvbsched.
96
dvbcat can be used to extract a stream from the dvbd for live TV.
97
</p>
98

    
99
<p>
100
For example:
101
</p>
102

    
103
<pre>
104
  dvbcat dvb-t "BBC ONE" | mplayer -
105
</pre>
106

    
107
<p>
108
dvbsched is used to schedule a recording. Note that an output file
109
must be specified whose containing directory must be owned by the user
110
issuing the request. The directory must also be writable by the dvbd
111
program.
112
</p>
113

    
114
<p>
115
The time format is in at(1) format. See at's manpage for more
116
information about it.
117
</p>
118

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

    
123
<pre>
124
  mkdir /tmp/recordings
125
  dvbsched dvb-t "ITV 2" 19.20 32 /tmp/recordings/itv2.mpg
126
</pre>
127

    
128
<p>
129
If there is a clash the program will ask you if you want
130
to cancel your job.
131
</p>
132

    
133
<p>
134
dvblist shows the channels available to tune at the given 
135
priority (default is 10). 
136
</p>
137

    
138
<p>
139
For example:
140
</p>
141

    
142
<pre>
143
  dvblist dvb-t
144
</pre>
145

    
146
<p>
147
If there are some existing connections the list of channels
148
may be shorter than the full list. 
149
</p>
150

    
151
<h2>Contributing And Comments</h2>
152

    
153
<p>
154
Feedback, bug fixes, new features, patches and suggestions are very
155
welcome.  Please send to: jak (change the at to @ and the dot to .) at users dot sourceforge dot net or post on the
156
SourceForge project page.
157
</p>
158

    
159
</body>
160
</html>