3
Gather television listings, process them and organize your viewing.
4
XMLTV is a file format for storing TV listings, defined in xmltv.dtd.
5
Then there are several tools to produce and process these listings.
7
Please see doc/QuickStart for documentation on what each program does,
8
and xmltv.dtd for documentation on the file format.
10
Progress is being made for a 1.0 release. We've really been stable for
11
a while I and consider it well overdue.
13
* Changes in this release (0.5.50)
15
Add new XMLTV::Supplement capability to many grabbers. Those grabbers
16
will now check a XMLTV.ORG web server for channel-id and other
17
supplemental information. This ensures more current versions and should
18
make new channels available sooner for effected grabbers.
20
DTD has been changed. A "system" attribute has been added to <star-ratings>
21
and <star-ratings> now allows multiple instances.
23
tv_grab_na_dtv : New grabber for North America Direct TV users.
24
tv_grab_eu_epgdata New grabber for the commercial epgdata.com service
26
tv_grab_fr : Improves Color/B&W detection, autocorrect, actors, director field parsing
27
tv_grab_uk_rt: improved bad character handling. Added "recommended" and "deaf-signed" notations.
28
tv_grab_il : replace Locale::Hebrew module to Text::Bidi due licensing problems
29
tv_check : Skip --myreplaytv as MyReplayTV.com has been discontinued.
31
And of course bugfixes and polish.
35
Note: Windows users are strongly advised to use the pre-build EXE as installing
36
all the prerequisites is non-trivial. For those want to give it a go,
37
instructions are in doc/exe_build.html. Those instructions can be used for both
38
building xmltv.exe as well as a local install.
40
Basically installation instructions (unix):
47
To install in a custom directory, replace the first line with
50
% perl Makefile.PL PREFIX=/wherever/
52
The system requirements are perl 5.6 or later, and a few Perl modules.
53
You will be asked about some optional components; if you choose not to
54
install them then there are fewer dependencies. The full list of
62
Memoize (included with perl 5.8 and later)
63
Storable (included with perl 5.8 and later)
65
Archive::Zip (if you want to run tv_grab_uk_bleb)
66
CGI (if you want to run tv_pick_cgi)
67
Compress::Zlib (if you want to run tv_grab_se_swedb)
68
HTML::Parser 3.34 (for some of the grabbers which use HTML::Entities)
69
HTML::TableExtract (if you want to run tv_grab_na_icons)
70
HTML::TreeBuilder (for many of the grabbers)
71
HTTP::Cache::Transparent (if you want to run tv_grab_se_swedb)
72
HTTP::Cookies (if you want to run tv_grab_br_net)
73
IO::Scalar (if you want to run tv_grab_uk_bleb)
74
IO::Stringy (if you want to run tv_grab_se_swedb)
75
SOAP::Lite (if you want to run tv_grab_na_dd)
76
Term::ReadKey (if you want to run tv_grab_na_dd)
77
Text::Kakasi (if you want to run tv_grab_jp)
78
Tk (if you want to run tv_check)
79
Tk::TableMatrix (if you want to run tv_check)
80
WWW::Mechanize (if you want to run tv_grab_na_icons or tv_grab_br_net)
81
XML::LibXML (if you want to run tv_grab_se, tv_grab_se_swedb)
82
Unicode::UTF8simple (if you want to run tv_grab_pt)
84
You may have difficulty with the XML modules on perl 5.8.0 - if so
85
send mail to the xmltv-users list. Other perl versions should be OK.
87
The following modules are recommended, but the software still works
90
Term::ProgressBar (displays pretty progress meters)
91
PerlIO::gzip (for perl 5.8+) (makes tv_imdb a bit faster)
92
Lingua::Preferred 0.2.4 (helps with multilingual listings)
93
Unicode::String (non-ASCII chars in LaTeX output)
94
Lingua::EN::Numbers::Ordinate (not really needed, to be honest)
96
And the Log::TraceMessages module is useful for debugging, but not
97
needed for normal use.
99
All of these can be installed with tarballs downloaded from CPAN or
100
(hopefully) using the CPAN shell program: 'perl -MCPAN -e shell', then
101
'install XML::Twig' and so on. But you may find it easier to search
102
for packaged versions from your OS vendor or others - places which
103
distribute a packaged version of xmltv will often provide the modules
108
Proxy server support is provide by the LWP modules.
109
You can define a proxy server via the HTTP_PROXY enviornment variable.
110
http_proxy=http://somehost.somedomain:port
112
For more information, see the the following:
113
http://search.cpan.org/~gaas/libwww-perl-5.803/lib/LWP/UserAgent.pm#$ua->env_proxy
117
tv_grab_se_swedb sometimes fails to work on Windows if there are spaces
118
in the path to your home-directory. This can be avoided by setting
119
the environment variable HOME to a path without spaces (e.g. c:\home).
123
This is free software distributed under the GPL, see COPYING. But if
124
you would like to use the code under some other conditions, please do
125
ask. There are many who have contributed code, they are credited in
126
individual source files.
128
There is a web page at http://www.xmltv.org and a Sourceforge
129
project 'XMLTV'. There are some mailing lists:
131
xmltv-announce@lists.sourceforge.net
132
xmltv-users@lists.sourceforge.net
133
xmltv-devel@lists.sourceforge.net
135
You ought to subscribe to the announce list at least. Contact the
136
users list with most problems.
138
$Id: README,v 1.150 2007/11/05 08:14:20 rmeden Exp $
3
Gather television listings, process them and organize your viewing.
4
XMLTV is a file format for storing TV listings, defined in xmltv.dtd.
5
Then there are several tools to produce and process these listings.
7
Please see doc/QuickStart for documentation on what each program does,
8
and xmltv.dtd for documentation on the file format.
10
Progress is being made for a 1.0 release. We've really been stable for
11
a while I and consider it well overdue.
13
* Changes in this release (0.5.52)
15
tv_grab_uk_rt: lots of improvements.. should upgrade
17
tv_grab_re: better season/episode number handling
18
tv_grab_be: responding to source site changes
19
tv_grab_fr: better title detection
20
tv_grab_huro: now generates stop times
21
tv_grab_na_dtv: responding to source site changes
22
tv_grab_pt: responding to source site changes
23
tv_grab_za: improve episode tags
25
not working, removed: tv_grab_il, tv_grab_nl_wolf
27
And of some bugfixes and polish.
31
Note: Windows users are strongly advised to use the pre-build EXE as installing
32
all the prerequisites is non-trivial. For those want to give it a go,
33
instructions are in doc/exe_build.html. Those instructions can be used for both
34
building xmltv.exe as well as a local install.
36
Basically installation instructions (unix):
43
To install in a custom directory, replace the first line with
46
% perl Makefile.PL PREFIX=/wherever/
48
The system requirements are perl 5.6 or later, and a few Perl modules.
49
You will be asked about some optional components; if you choose not to
50
install them then there are fewer dependencies. The full list of
58
Memoize (included with perl 5.8 and later)
59
Storable (included with perl 5.8 and later)
61
Archive::Zip (if you want to run tv_grab_uk_bleb)
62
CGI (if you want to run tv_pick_cgi)
63
Compress::Zlib (if you want to run tv_grab_se_swedb)
64
HTML::Parser 3.34 (for some of the grabbers which use HTML::Entities)
65
HTML::TableExtract (if you want to run tv_grab_na_icons)
66
HTML::TreeBuilder (for many of the grabbers)
67
HTTP::Cache::Transparent (if you want to run tv_grab_se_swedb)
68
HTTP::Cookies (if you want to run tv_grab_br_net)
69
IO::Scalar (if you want to run tv_grab_uk_bleb)
70
IO::Stringy (if you want to run tv_grab_se_swedb)
71
SOAP::Lite (if you want to run tv_grab_na_dd)
72
Term::ReadKey (if you want to run tv_grab_na_dd)
73
Text::Kakasi (if you want to run tv_grab_jp)
74
Tk (if you want to run tv_check)
75
Tk::TableMatrix (if you want to run tv_check)
76
WWW::Mechanize (if you want to run tv_grab_na_icons or tv_grab_br_net)
77
XML::LibXML (if you want to run tv_grab_se, tv_grab_se_swedb)
78
Unicode::UTF8simple (if you want to run tv_grab_pt)
80
You may have difficulty with the XML modules on perl 5.8.0 - if so
81
send mail to the xmltv-users list. Other perl versions should be OK.
83
The following modules are recommended, but the software still works
86
Term::ProgressBar (displays pretty progress meters)
87
PerlIO::gzip (for perl 5.8+) (makes tv_imdb a bit faster)
88
Lingua::Preferred 0.2.4 (helps with multilingual listings)
89
Unicode::String (non-ASCII chars in LaTeX output)
90
Lingua::EN::Numbers::Ordinate (not really needed, to be honest)
92
And the Log::TraceMessages module is useful for debugging, but not
93
needed for normal use.
95
All of these can be installed with tarballs downloaded from CPAN or
96
(hopefully) using the CPAN shell program: 'perl -MCPAN -e shell', then
97
'install XML::Twig' and so on. But you may find it easier to search
98
for packaged versions from your OS vendor or others - places which
99
distribute a packaged version of xmltv will often provide the modules
104
Proxy server support is provide by the LWP modules.
105
You can define a proxy server via the HTTP_PROXY enviornment variable.
106
http_proxy=http://somehost.somedomain:port
108
For more information, see the the following:
109
http://search.cpan.org/~gaas/libwww-perl-5.803/lib/LWP/UserAgent.pm#$ua->env_proxy
113
tv_grab_se_swedb sometimes fails to work on Windows if there are spaces
114
in the path to your home-directory. This can be avoided by setting
115
the environment variable HOME to a path without spaces (e.g. c:\home).
119
This is free software distributed under the GPL, see COPYING. But if
120
you would like to use the code under some other conditions, please do
121
ask. There are many who have contributed code, they are credited in
122
individual source files.
124
There is a web page at http://www.xmltv.org and a Sourceforge
125
project 'XMLTV'. There are some mailing lists:
127
xmltv-announce@lists.sourceforge.net
128
xmltv-users@lists.sourceforge.net
129
xmltv-devel@lists.sourceforge.net
131
You ought to subscribe to the announce list at least. Contact the
132
users list with most problems.
134
-- Robert Eden, rmeden@yahoo.com, 2008-07-13
135
$Id: README,v 1.153 2008/07/14 04:05:55 rmeden Exp $