tvheadend/docs/html/epg.html
Andrew C. Martin 7764b5618e documentation updates
- fix typos/misspellings in documentation
- fix broken link on how to build Tvheadend
- standardize on most commonly used capitalization of "Tvheadend"
- update copyright year to 2013
- break up the handful of run-on lines
2013-02-21 21:23:43 -07:00

95 lines
3.6 KiB
HTML

<div class="hts-doc-text">
Tvheadend has a built in Electronic Program Guide. The EPG is an in memory
database populated with all the information about events received from
the DVB networks or from XMLTV.
<p>
The EPG tab displays a filterable paged grid containing all the events
sorted based on start time.
<img src="docresources/epg.png">
<p>
<dl>
<dt>Filtering (or searching)
<dd>
In the EPG top tool bar you can access four input fields.
These are used to filter/search for events. The form uses implicit AND
between the input fields. This means that all filters must match
for an event to be displayed.
<dl>
<dt>[Search title...]
<dd>
Filter on the event title. The filter uses case insensitive regular
expression. If you don't know what a regular expression is this means
that you can type just parts of the title and filter on that too.
(No need for exact matching).
<dt>[Filter channel...]
<dd>
Only display events from the selected channel. Channels in the drop down are
ordered by channel number and can be filtered (by name) by typing in the box.
<dt>[Filter tag...]
<dd>
Only display events from the channels which are included in the selected tag.
Tags are used for grouping channels and is configured by the administrator.
<dt>[Filter content type...]
<dd>
Most DVB networks classify their events into content groups. This field
allows you to filter based on content type.
</dl>
Thus, if you only would like to browse Movies from your HD-channels you
would select 'HDTV' in the [Filter tag...]-field, and select
'Movie / Drama' in the [Only include content...]-field.
<p>
Notice that you don't have to press a 'Search' button, the grid immediately
updates itself as you change the filters.
<p>
If you would like to clear all filters, just press the [Reset] button.
<dt>Paging
<dd>
In large installations with many channels and full EPG feed there could be
tens of thousands of events in the database.
Therefore the EPG display employs a paging bar at the bottom of the grid.
Use it to browse backwards and forwards in the EPG. It also displays the
total amount of events matched by the current query.
<dt>Event details and recording
<dd>
If you click on a single event, a popup will display detailed information
about the event. It also allows the user to schedule the event for recording
by clicking on the [Record program] button.
<p>
For EPG providers that supply series link information there will also be a
[Record series] button that will record all entries in the series.
<p>
For events without any series link information, a [Autorec] button will be
provided to create a pseudo series link using the Autorec feature.
<p>
<img src="docresources/epg2.png">
<p>
To close the popup, just close it with the [X] window button.
The popup is not modal and you can open as many detailed information popups
as you want.
<dt>Autorecordings
<dd>
Should you wish to record all events matching a specific query. (Record
your favorite TV-show, etc) you can press the [Create Autorec] button
in the top toolbar.
<p>
A popup with details about the to-be-created autorecording rule needs to
be confirmed before the rule takes effect.
<p>
<img src="docresources/autorecpopup.png">
<p>
The autorecordings can later be changed/deleted in under the
'Digital Video Recorder'-tag. Use that editor if you temporary want
to disable an autorecording or make adjustments, etc.
<dt>Watch TV
<dd>
If you want to watch live TV in the web UI, the [Watch TV] button will pop-up
a VLC plugin window (if you don't have the plugin installed a direct URL should be
provided to load into your preferred media player).
</dl>
</div>