Repository files navigation

• XMLTV
  • Description
  • Changes
  • Installation (Package)
    • Linux
    • Windows
    • MacOS
  • Installation (Source)
    • Getting Source Code
    • Building
    • Required distributions/modules
    • Recommended distributions/modules
    • JSON libraries
    • CPAN
    • Proxy servers
  • Known issues
  • License
  • Authors
  • Resources

The XMLTV project provides a suite of software to gather television listings, process listings data, and help organize your TV viewing.

XMLTV listings use a mature XML file format for storing TV listings, which is defined and documented in theXMLTV DTD.

In addition to the many "grabbers" that provide listings for large parts of the world, there are also several tools to process and filter these listings.

Please see ourQuickStart documentation for details on what each program does.

To see what has changed in the current XMLTV release please check theChanges file.

XMLTV is packaged for most major Linux distributions and FreeBSD. It is recommended that users install XMLTV using their preferred package manager.

% sudo apt install xmltv

% dnf install xmltv

Windows users are strongly advised to use thepre-built binary as installing all prerequisites is non-trivial. Please also check the Github release page for a pre-built release binary.

For those who want to give it a go, please read theEXE build instructions. The instructions can be used for both building xmltv.exe as well as a local install.

XMLTV is packaged for MacOS in theMacPorts Project

The source code for the current release can be downloaded as a tarball (or zipfile) fromGitHub and extracted to a preferred location.

The source code for all previous, current and future releases is available in our GitHub repository:

% git clone https://github.com/XMLTV/xmltv.git

To build from source please ensure all required modules are available (see below). Change to the directory containing the XMLTV source:

% perl Makefile.PL% make% maketest% make install

To install to a custom directory, update the first line to provide a suitablePREFIX location:

% perl Makefile.PL PREFIX=/opt/xmltv/

The system requirements are Perl 5.8.3 or later, and a few Perl modules. You will be asked about some optional components; if you choose not to install them then there are fewer dependencies.

Please note that in addition to the specific modules listed below, thetv_grab_zz_sdjson_sqlite grabber requires Perl 5.16 to be installed.

Required distributions/modules for XMLTV's core libraries are:

Date::Manip 5.42aFile::SlurpJSON (see note below)HTTP::RequestHTTP::ResponseLWP 5.65LWP::UserAgentLWP::Protocol::httpsTerm::ReadKeyURIXML::LibXMLXML::Parser 2.34XML::TreePPXML::Twig 3.28XML::Writer 0.6.0

Required modules for grabbers/utilities are:

CGI                           (tv_pick_cgi, core module until 5.20.3, part of CGI)CGI::Carp                     (tv_pick_cgi, core module until 5.20.3, part of CGI)Compress::Zlib                (for some of the grabbers, core module since 5.9.3, part of IO::Compress)Data::Dump                    (for tv_grab_it_dvb)Date::Format                  (for some of the grabbers, part of TimeDate)DateTime                      (for several of the grabbers)DateTime::Format::ISO8601     (tv_grab_zz_sdjson_sqlite)DateTime::Format::SQLite      (tv_grab_zz_sdjson_sqlite)DateTime::TimeZone            (tv_grab_fr)DBD::SQLite                   (tv_grab_zz_sdjson_sqlite)DBI                           (tv_grab_zz_sdjson_sqlite)Digest::SHA                   (tv_grab_zz_sdjson{,_sqlite}, core module since 5.9.3)File::HomeDir                 (tv_grab_zz_sdjson_sqlite)File::Which                   (tv_grab_zz_sdjson_sqlite)HTML::Entities 1.27           (for several of the grabbers, part of HTML::Parser 3.34)HTML::Parser 3.34             (tv_grab_it, tv_grab_it_dvb, part of HTML::Parser 3.34)HTML::Tree                    (for many of the grabbers, part of HTML::Tree)HTML::TreeBuilder             (for many of the grabbers, part of HTML::Tree)HTTP::Cache::Transparent 1.0  (for several of the grabbers)HTTP::Cookies                 (for several of the grabbers)IO::Scalar                    (for some of the grabbers, part of IO::Stringy)List::MoreUtils               (tv_grab_zz_sdjson_sqlite)LWP::Protocol::https          (tv_grab_fi, tv_grab_huro, tv_grab_zz_sdjson)LWP::UserAgent::Determined    (tv_grab_zz_sdjson_sqlite)SOAP::Lite 0.67               (tv_grab_na_dd)Time::Piece                   (tv_grab_huro, core module since 5.9.5)Time::Seconds                 (tv_grab_huro, core module since 5.9.5)Tk                            (tv_check)Tk::TableMatrix               (tv_check)URI                           (for some of the grabbers, part of URI)URI::Encode                   (tv_grab_pt_vodafone)URI::Escape                   (for some of the grabbers, part of URI)XML::DOM                      (tv_grab_is)XML::LibXSLT                  (tv_grab_is)

When building XMLTV, any missing modules that are required for the selected grabbers/utilities will be reported.

The following modules are recommended but XMLTV works without them installed:

File::chdir                      (testing grabbers)JSON::XS                         (faster JSON handling, see note below)Lingua::Preferred 0.2.4          (helps with multilingual listings)Log::TraceMessages               (useful for debugging, not needed for normal use)PerlIO::gzip                     (can make tv_imdb a bit faster)Term::ProgressBar                (displays pretty progress bars)Unicode::String                  (improved character handling in tv_to_latex)URI::Escape::XS                  (faster URI handling)

By default, libraries and grabbers that need to handle JSON data should specify the JSON module. This module is a wrapper for JSON::XS-compatible modules and supports the following JSON modules:

JSON::XSJSON::PPCpanel::JSON::XS

JSON will use JSON::XS if available, falling back to JSON::PP (a core module since 5.14.0) if JSON::XS is not available. Cpanel::JSON::XS can be used as an explicit alternative by setting the PERL_JSON_BACKEND environment variable(please refer to the JSON module's documentation for details).

All required modules can be quickly installed from CPAN using thecpanm utility. For example:

% cpanm XML::Twig

Please note that you may find it easier to search for packaged versions of required modules, as sources which distribute a packaged version of XMLTV also provide packaged versions of required modules.

Proxy server support is provide by the LWP modules. You can define a proxy server via the HTTP_PROXY environment variable.

% HTTP_PROXY=http://somehost.somedomain:port

For more information, see thisarticle

If a full HTTP URL to the XMLTV.dtd is provided in the DOCTYPE declaration of an XMLTV document, please be aware that it is possible for the link to instead redirect to a page for accepting cookies. Such cookie-acceptance pages are more common in Europe, and can result in applications being unable to parse the file.

XMLTV is free software, distributed under the GNU General Public License, version 2. Please seeCOPYING for more details.

There have been many contributors to XMLTV. Where possible they are credited in individual source files and in theauthors mapping file.

OurGitHub project contains all source code, issues and Pull Requests.

We have a projectweb page and wiki

We run the following mailing lists:

• xmltv-users: for users to ask questions and report problems with XMLTV software

• xmltv-devel: for development discussion and support

• xmltv-announce: announcements of new XMLTV releases

We run an IRC channel #xmltv on Libera Chat. Please join us!

-- Nick Morrott,knowledgejunkie@gmail.com, 2024-02-24