XMLTV 0.6.3, Windows binary release

Gather television listings, process them and organize your viewing.
XMLTV is a file format for storing TV listings, defined in xmltv.dtd.
Then there are several tools to produce and process these listings.

Please see doc\QuickStart for documentation on what each program does,
and xmltv.dtd for documentation on the file format.

This is a release of the software as a single Windows binary
xmltv.exe, generated from the Perl source code linked from
<https://github.com/XMLTV/xmltv>.

* Known problems

Due to prerequisite problems, EXE support is not currently available
for tv_grab_is and tv_grab_it_dvb, If you need one
of those you'll need to install Perl and the necessary modules and
use the full distribution.

* Major Changes in this release (0.6.3)

tv_grab_ch_search:   disable broken grabber

* Major Changes in previous release (0.6.2)

tv_grab_dotmedia:    disable deprecated grabber
tv_grab_se_tvzon:    disable deprecated grabber

tv_grab_dtv_la:      disable broken grabber
tv_grab_il:          disable broken grabber
tv_grab_pt_meo:      disable broken grabber
tv_grab_se_swedb:    disable broken grabber

XMLTV.pm:            update handling of reading from STDIN due to
                     XML::Parser adopting 3-arg open
tv_grab_ch_search:   handle upstream cookies
tv_grab_eu_epgdata:  various fixes and improvements
tv_grab_fi:          various fixes and improvements
tv_grab_fr:          update grabber due to upstream changes
tv_grab_huro:        use https source site URLs
tv_grab_it:          fix overlapping/duplicate programmes
tv_grab_na_dd:       use https source site URLs
tv_grab_na_dtv:      various fixes and improvements
tv_grab_pt_vodafone: various fixes and improvements
tv_grab_uk_tvguide:  various fixes and improvements
tv_grab_zz_sdjson_sqlite:
                     many fixes and improvements

And many other changes (see the git log for details)

There is no installer, just unpack the zipfile into a
directory such as C:\xmltv.  If you are reading this you've probably
already done that.

All the different programs are combined into a single executable.  For
example, instead of running 'tv_grab_na --days 2 >na.xml' you would run

c:\xmltv\xmltv.exe tv_grab_na_dd --days 2 --output a.xml

Apart from the extra 'xmltv.exe' at the front of each command line,
the usage should be the same as the Unix version.  Some programs make
use of a "share" directory.  That directory is assumed be named
"share" at the same location as the exe.  If you just keep everything
where you unzipped it, everything should be fine.  If you must move
xmltv.exe, you may need to specify a --share option with some
programs.

xmltv.exe will try and guess a timezone.  This usually works fine. If
it doesn't, you can set a TZ variable just like on unix.

* General Windows Notes

Spaces in filenames may cause problems with some programs.  Directories
with spaces (i.e. C:\program files\xmltv) are not recommended.
C:\xmltv is better.

Some of the programs allow you pass a date format on the command line.
This uses % followed by a letter to specify a component of a date, for
example %Y gives a four digit year.  This can cause problems on windows
since % is used as a shell escape character.

To get around this, use %% to pass a % to the application. (ex. %%Y%%M )

If you *DO* want to insert a shell variable, you can do so by surrounding
it with percents. (ex %HOME% )

* Proxy servers

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 the following documentation:
    https://metacpan.org/pod/LWP::UserAgent#PROXY-ATTRIBUTES

* Author and copying

This is free software distributed under the GPL, see COPYING.  But if
you would like to use the code under some other conditions, please do
ask.  The Windows executable distribution was created by Robert Eden;
for details of the many contributors to the project please download
the source code.

There is a web page at <http://xmltv.org/> and a Github repository at
<https://github.com/XMLTV/xmltv> where you can download the source code.

Sourceforge hosts the following mailing lists:
    xmltv-announce - low volume announcements. Please join this at least.
    xmltv-users    - how to use XMLTV
    xmltv-devel    - detailed discussions among developers

-- Nick Morrott, knowledgejunkie@gmail.com, 2020-08-22
