Statistics
| Branch: | Tag: | Revision:

dvbd / dvbdguide / README @ 4e104f20

History | View | Annotate | Download (2.83 KB)

1
dvbdguide (jak@users.sourceforge.net)
2

    
3
Installing the TV Guide CGI script
4
----------------------------------
5

    
6
Prerequisites:
7
   xsltproc - http://www.xmlsoft.org/
8

    
9
   perl - http://www.perl.com
10

    
11
   apache - http://www.apache.org/
12
      or other webserver supporting CGI
13
     
14
   dvbd - http://dvbd.sourceforge.net/
15
     
16
   Debian users: apt-get install perl xsltproc xmltv 
17
                 dpkg -i dvbd*.deb
18

    
19
1. This program is written to more easily schedule programs
20
   with dvbd. Make sure that the utility programs dvblist and
21
   dvbsched are in your path since they are invoked by tv.cgi
22
   script.
23

    
24
2. The TV Guide is based on an XMLTV compatible data source.
25
   You need to ensure that the listings for today are in a 
26
   file called listings.0.xml. Listings for tomorrow (if you
27
   have them should be in listings.1.xml, the day after
28
   in listings.2.xml and so on). 
29
   
30
   I use bleb2xmltv (http://www.doc.ic.ac.uk/~jak97/bleb/bleb2xmltv.tar.bz2)
31
   for basic UK listings, although the RadioTimes grabber should
32
   work well too. Since bleb2xmltv automatically rotates it's listings files
33
   making symbolic links to the /var/cache/bleb is good enough:
34

    
35
       listings.0.xml -> /var/cache/bleb/listings.0.xml
36
       listings.1.xml -> /var/cache/bleb/listings.1.xml
37
       ...
38

    
39
3. If you are using Apache, make sure that Apache has user directories and CGI enabled.
40
   For Apache2 make sure that the following is in your /etc/apache2/apache2.conf.
41
   NB ExecCGI option.
42
   
43
----8<----
44
UserDir public_html
45

    
46
<Directory /home/*/public_html>
47
	AllowOverride FileInfo AuthConfig Limit
48
	Options Indexes SymLinksIfOwnerMatch ExecCGI
49
</Directory>
50
----8<----
51

    
52
3. Make a ~/public_html directory
53

    
54
4. Copy the tv.cgi tv.xsl tv.css to ~/public_html
55
   cp tv.cgi tv.xsl tv.css ~/public_html
56

    
57
5. Make sure that listings.xml for today's TV listings is 
58
   present in ~/public_html
59

    
60
6. Make a recordings directory somewhere on your computer.
61
   Edit ~/public_html/tv.cgi:
62

    
63
   $recordingPath = "/home/jak/recordings";
64

    
65
   to point to a directory that you want to record to. 
66

    
67
   NB: the directory should be owned by you, but in the
68
   dvdb group, user and group writable.
69

    
70
7. Add any xmltv id to DVB id mappings in ~/public_html/tv.cgi
71
   I have added the ones for the channels I watch on UK freeview.
72

    
73
8. Assuming that dvbd is properly configured and running,
74
   open the web browser at http://yourhost/~youruser/tv.cgi
75
   Hopefully all should work!
76

    
77
9. If you have different favourite programs to me, edit
78
   ~/public_html/favourites.xml as appropriate.
79

    
80
10. Please send comments, suggestions, patches and contributions 
81
    to jak@users.sourceforge.net
82

    
83
TROUBLESHOOTING
84
---------------
85

    
86
1. If the page comes up blank, check that the listings.0.xml files are
87
   present and correct.
88

    
89
ACKNOWLEDGEMENTS
90
----------------
91

    
92
This code is based off tv-control by 
93
xmltvcntl@SlashHomeSlashAdrian.fsnet.co.uk