Statistics
| Branch: | Tag: | Revision:

dvbd / README @ acd567bd

History | View | Annotate | Download (3.05 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 (dvbcat, dvbsched,
8
dvblist).  It is possible to associate a priority with a connection to
9
the daemon, so that (depending on the given priority) the tuner can be
10
made available by dropping connections of inferior priority.
11

    
12
DVB-T, DVB-S, DVB-C supported.
13

    
14
Also read dvbdguide/README.dvbdguide if you are interested in a 
15
web frontend for this program.
16

    
17
** BUILDING
18

    
19
It is important to specify a prefix for configure, even if you are planning to
20
install to /usr/local. For example:  ./configure --prefix=/usr/local
21

    
22
** CONFIGURATION
23

    
24
The daemon has a configuration file which by default is
25
/etc/dvbd/config. The format of the file is lines of key=value. Line
26
comments can be begun with #.
27

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

    
51
If no cards are specified, a default of one dvb-t card is assumed with
52
channels file /etc/tzap.channels.conf and frontend
53
/dev/dvb/adapter0/frontend0
54

    
55
** CLIENT PROGRAMS
56

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

    
60
For example:
61

    
62
  dvbcat dvb-t "BBC ONE" | mplayer -
63

    
64
dvbsched is used to schedule a recording. Note that an output file
65
must be specified whose containing directory must be owned by the user
66
issuing the request. The directory must also be writable by the dvbd
67
program.
68

    
69
The time format is in at(1) format. See at's manpage for more
70
information about it.
71

    
72
For example:
73

    
74
  mkdir ~/recordings
75
  dvbsched dvb-t "ITV 2" 19.20 32 ~/recordings/itv2.mpg
76

    
77
If there is a clash the program will ask you if you want
78
to cancel your job.
79

    
80
dvblist shows the channels available to tune at the given 
81
priority (default is 10). 
82

    
83
For example:
84

    
85
  dvblist dvb-t
86

    
87
If there are some existing connections the list of channels
88
may be shorter than the full list. 
89

    
90
** CONTRIBUTING AND COMMENTS 
91

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