tvheadend/docs/html/config_epggrab.html

80 lines
4 KiB
HTML

<div class="hts-doc-text">
<p>
This tab is used to configure EPG grabbing capabilities. TVheadend supports
a variety of different EPG grabbing mechanisms. These fall into 3 broad
categories, within which there are a variety of specific grabber
implementations.
</p>
<h2>Grabber Types</h2>
<ul>
<li>Over-the-Air (OTA) - These grabbers receive EPG data directly from the DVB network. This is often the easiest way to get up and running and does provide timely updates should scheduling change. However the information isn't always as rich as some of the other grabbers.
<li>Internal - These are grabbers which can be internally initiated from within TVheadend using a very simple scheduler. These are typically Internet based services. This can be a quick way to get richer EPG data where you don't have decent OTA support.
<li>External - These provide the option to run grabber scripts externally and to send data into TVheadend via Unix domain sockets. It provides the ability to run more complex configurations using things like cronjob's, script chains, etc.
</ul>
<h2>Grabber Modules</h2>
<ul>
<li>EIT - This is a DVB standards compatible EIT grabber. Typically it will
retrieve now/next information, though on some networks there may be more
extensive data published.
<li>Freesat/view - This is an extended version of EIT that is used by the Free-to-air DVB providers in the UK. It includes additional information such as series links and episode identifiers.
<li>OpenTV - This is a proprietary OTA EPG grabber. Its known to be used on the SKY networks, but others may use it. You need two configuration files to define settings for your particular network, if you don't see yours listed please visit IRC #hts for help.
<li>XMLTV - This is am Internet based suite of scripts, for more information about XMLTV please visit <a href="http://www.xmltv.org">http://www.xmltv.org</a>. To make use of the internal XMLTV grabber you typically require the xmltv-utils package to be installed. If you install new grabbers you will need to restart TVheadend to pick these up as they're loaded at startup. If you see no XMLTV grabbers listed then most probably XMLTV is not properly installed and in the PATH.
<li>PyEPG - This is another Internet based scraper. It currently only supports the Atlas UK system (for which you need a key), but it does provide a very rich EPG data set. For more information see <a href='http://github.com/adamsutton/PyEPG'>http://github.com/adamsutton/PyEPG</a>.</li>
</ul>
<h2>Configuration options</h2>
<h3>General Config</h3>
<dl>
<dt>Update channel name
<dd>Automatically update channel names using information provided
by the enabled EPG providers.
<dt>Update channel number
<dd>Automatically update channel numbers using information provided
by the enabled EPG providers.
<dt>Update channel name
<dd>Automatically update channel icons using information provided
by the enabled EPG providers.
</dl>
<h3>Internal Grabber</h3>
<dl>
<dt>Module:
<dd>Select which internal grabber to use.
<dt>Grab interval
<dd>Time period between grabs. Value and unit are indepdently set.
</dl>
<h3>Over-the-air Grabbers</h3>
<p>
Checkbox list to enable/disable available modules.
By default all grabbers should be enabled.
<h3>External interfaces</h3>
<p>
Checkbox list to enable/disable available modules. The path field
contains the absolute path of the unix domain socket into which EPG
data can be sent.`
<p>
To send data to the socket use the command "netcat -u SOCKET_PATH".
<br/>
Note: for some systems the netcat flags can vary so please consult the
man page.
<h2>Notes</h2>
<p>
To apply any changes please use the [Save configuration button]
<p>
XMLTV/PyEPG - if you are using the internal versions of these modules then
you must first configure them externally as Tvheadend provides
no support for this. Nor does it provide the ability to pass command line
options (for this use the external interface).
</p>
</div>