Statistics
| Branch: | Tag: | Revision:

dvbd / README @ bfdb7446

History | View | Annotate | Download (2.91 KB)

1
* dvbd
2

    
3
** INTRODUCTION
4

    
5
The idea behind dvbd is to make maximum use of your DVB card by
6
allowing multiple channels on the same frequency to be tuned. It is
7
split into a daemon (dvbd) and client programs (dvbclient, dvblist).
8
It is possible to associate a priority with a connection to the
9
daemon, so that (depending on the given priority) the tuner can be
10
made available by dropping connections of inferior priority.
11

    
12
NB, at the moment only DVB-T is supported (that's the type of DVB that
13
I have), but it should be fairly easy to add support for DVB-S and
14
DVB-C.
15

    
16
** CONFIGURATION
17

    
18
The daemon has a configuration file which by default is
19
/etc/dvbd/config. The format of the file is lines of key=value. Line
20
comments can be begun with #.
21

    
22
The following configuration fields are available:
23
  socket   - the (unix) socket to listen on. 
24
	     Default is /var/run/dvbd/dvbd.socket
25
  pid      - the pid file to write to once
26
	     it has become a daemon.
27
	     Default is /var/run/dvbd/dvbd.pid
28
  log      - the log file to write to
29
	     Default is /var/log/dvbd.log
30
  schedule - the schedule file to write to
31
	     Default is /var/spool/dvbd/schedule
32
  debug    - the debug level (default is 0) If a higher
33
             debug level is set, dvbd will not go into the
34
	     background.
35
  numcards - the number of DVB cards your system supports
36
  card0    - the first DVB card. The format of this field is 
37
             type:frontend:channels
38
             Where 
39
               - type may be one of dvb-t, dvb-s or dvb-t.
40
               - frontend is the path to the frontend (tuner)
41
                 for the card
42
               - channels is the path to the tzap/szap/czap format
43
                 channels.conf file for the card.
44

    
45
If no cards are specified, a default of one dvb-t card is assumed with
46
channels file /etc/tzap.channels.conf and frontend
47
/dev/dvb/adapter0/frontend0
48

    
49
** CLIENT PROGRAMS
50

    
51
At the moment there are three client programs. dvbcat, dvblist and dvbsched.
52
dvbcat can be used to extract a stream from the dvbd for live TV.
53

    
54
For example:
55

    
56
  dvbcat dvb-t "BBC ONE" | mplayer -
57

    
58
dvbsched is used to schedule a recording. Note that an output file
59
must be specified whose containing directory must be owned by the user
60
issuing the request. The directory must also be writable by the dvbd
61
program.
62

    
63
The time format is in at(1) format. See at's manpage for more
64
information about it.
65

    
66
For example:
67

    
68
  mkdir /tmp/recordings
69
  dvbsched dvb-t "ITV 2" 19.20 32 /tmp/recordings/itv2.mpg
70

    
71
If there is a clash the program will ask you if you want
72
to cancel your job.
73

    
74
dvblist shows the channels available to tune at the given 
75
priority (default is 10). 
76

    
77
For example:
78

    
79
  dvblist dvb-t
80

    
81
If there are some existing connections the list of channels
82
may be shorter than the full list. 
83

    
84
** CONTRIBUTING AND COMMENTS 
85

    
86
Feedback, bug fixes, new features, patches and suggestions are very
87
welcome.  Please send to jak@users.sourceforge.net or post on the
88
SourceForge project page.