"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/index.docbook" between
kaffeine-2.0.16.tar.gz and kaffeine-2.0.17.tar.gz

About: Kaffeine is a full featured Multimedia-Player for KDE (default backend is xine).

index.docbook  (kaffeine-2.0.16):index.docbook  (kaffeine-2.0.17)
skipping to change at line 44 skipping to change at line 44
<affiliation> <affiliation>
<address><email>mchehab+kde@kernel.org</email></address> <address><email>mchehab+kde@kernel.org</email></address>
</affiliation> </affiliation>
</author> </author>
</authorgroup> </authorgroup>
<!-- TRANS:ROLES_OF_TRANSLATORS --> <!-- TRANS:ROLES_OF_TRANSLATORS -->
<copyright> <copyright>
<year>2004</year> <year>2004</year>
<year>2016</year> <year>2016-2019</year>
<year>2017</year>
<year>2018</year>
<holder>The &kaffeine; Authors.</holder> <holder>The &kaffeine; Authors.</holder>
</copyright> </copyright>
<legalnotice>&FDLNotice;</legalnotice> <legalnotice>&FDLNotice;</legalnotice>
<date>2018-04-27</date> <date>2019-05-01</date>
<releaseinfo>&kaffeine; 2.0.15</releaseinfo> <releaseinfo>&kaffeine; 2.0.17</releaseinfo>
<!-- Abstract about this handbook --> <!-- Abstract about this handbook -->
<abstract> <abstract>
<para> <para>
<ulink url="https://www.kde.org/applications/multimedia/kaffeine/">Kaffeine</uli nk> is a Media Player by &kde;. <ulink url="https://www.kde.org/applications/multimedia/kaffeine/">Kaffeine</uli nk> is a Media Player by &kde;.
</para> </para>
</abstract> </abstract>
<keywordset> <keywordset>
skipping to change at line 206 skipping to change at line 204
The <guimenu>General Options</guimenu> menu allows setting the The <guimenu>General Options</guimenu> menu allows setting the
device-independent settings. device-independent settings.
</para> </para>
<para> <para>
The <guilabel>Recording folder</guilabel> sets the location where all TV The <guilabel>Recording folder</guilabel> sets the location where all TV
program records will be stored. program records will be stored.
</para> </para>
<para> <para>
The <guilabel>xmltv file name (optional)</guilabel> specifies a file name
with EPG data that was retrieved via an external grabber. When this
option is used, you'll likely set <guilabel>Disable parsing Electronic
Program Guide (EPG) data from MPEG-TS tables</guilabel>
</para>
<para>
The <guilabel>Disable parsing EPG data
from MPEG-TS tables</guilabel> disables the Electronic Program Guide (EPG)
data to be retrieved from the broadcasted signal. Use it in order to save
some CPU time, if your broadcaster doesn't send reliable EPG data.
</para>
<para>
The <guilabel>Time shift folder</guilabel> is used in conjunction with the The <guilabel>Time shift folder</guilabel> is used in conjunction with the
pause button pause button
(<inlinemediaobject><imageobject><imagedata fileref="media-playback-pause-circul ar.png" format="PNG"/></imageobject></inlinemediaobject>) of the media player sc reen. When the button (<inlinemediaobject><imageobject><imagedata fileref="media-playback-pause-circul ar.png" format="PNG"/></imageobject></inlinemediaobject>) of the media player sc reen. When the button
is pressed, a time shift file will be stored at the location pointed by this is pressed, a time shift file will be stored at the location pointed by this
menu option. menu option.
</para> </para>
<para> <para>
The <guilabel>Begin margin</guilabel> and <guilabel>End margin</guilabel> The <guilabel>Begin margin</guilabel> and <guilabel>End margin</guilabel>
options are used to setup a sort of <quote>security margin</quote> in order options are used to setup a sort of <quote>security margin</quote> in order
skipping to change at line 303 skipping to change at line 315
ISO-6937 encoding. If set, the default changes to ISO 8859-1. ISO-6937 encoding. If set, the default changes to ISO 8859-1.
</para> </para>
<para> <para>
The <guilabel>Create info files to accompany EPG recordings</guilabel> The <guilabel>Create info files to accompany EPG recordings</guilabel>
option enables the creation of ancillary files for scheduled records option enables the creation of ancillary files for scheduled records
with the contents of the program guide for records made via the with the contents of the program guide for records made via the
<guimenu>Program guide</guimenu>. <guimenu>Program guide</guimenu>.
</para> </para>
<sect3 id="EPG-data">
<title>Electronic Program Guide (EPG) data retrieval</title>
<para>
Most digital TV broadcasters send program information via the broadcast
information, encoded on a MPEG-TS stream. However, some of them use
non-standard encodings for those data. As an example, at the United Kingdom,
HD programs EPG data are usually stored using some a proprietary
format. Other providers just don't fill the EPG data, or the information there
is not reliable.
</para>
<para>
Since &kaffeine; 2.0.17, it is possible to disable parsing the EPG data
from the broadcasted channels, using an external program to retrieve them.
In order to disable, just set the <guilabel>Disable parsing Electronic
Program Guide (EPG) data from MPEG-TS tables</guilabel> box. You can now set
an external parser to produce a file with EPG data, and use the
<guilabel>xmltv file name (optional)</guilabel> to specify the file name of
the produced file. The produced file should use the XMLTV format, as described
on its DTD. See <ulink url="http://wiki.xmltv.org/index.php/XMLTVFormat">
XMLTV File format</ulink> for more information.
</para>
<para>
When &kaffeine; is set to use an XMLTV file, it will automatically detect any
file changes on it. When a change happens, it will open the file and parse
its contents, updating EPG data accordingly.
</para>
<para>
It should be noticed that the XMLTV file has a table with associates its
own internal representation for channels with the expected channel name at
the digital TV broadcasted data. &kaffeine; will only retrieve the EPG data
if the channels there match the ones inside &kaffeine;'s channel list.
So, you need to ensure that the channels there matches what &kaffeine;
expects. If it doesn't match, you could use a command line &XML; editor program
in order to add the missing channel information.
</para>
<para>
For example, if you have a xmltv grabber program retrieving the file named
<emphasis>original_xmltv_file.xmltv</emphasis>, you could use the
<emphasis>xmlstarlet</emphasis> program to add missing
associations. So, if you want to associate the XMLTV channel named as
<emphasis>channel.foo.uk</emphasis> with a channel whose &kaffeine; name is
<emphasis>FOO</emphasis>, you could run this small script:
</para>
<para><programlisting>
channel="xmltv.channel.pt"
name="DVB_CHANNEL"
xmlstarlet ed \
-s "tv/channel[@id='$channel']" -t elem -n display-name \
-v "$name" original_xmltv_file.xmltv &gt; new_xmltv_file.xmltv
mv new_xmltv_file.xmltv /tmp/new_xmltv_file.xmltv
</programlisting>
</para>
<para>
Then, set &kaffeine; to use the new <emphasis>/tmp/new_xmltv_file.xmltv</emphasi
s>
file.
</para>
</sect3>
</sect2> </sect2>
<sect2 id="dtv-source-settings"> <sect2 id="dtv-source-settings">
<title>Configuring digital TV sources</title> <title>Configuring digital TV sources</title>
<screenshot> <screenshot>
<screeninfo>TV Device Configuration</screeninfo> <screeninfo>TV Device Configuration</screeninfo>
<mediaobject> <mediaobject>
<imageobject> <imageobject>
<imagedata fileref="kaffeine_configure_tv_isdb_device.png" format="PNG"/> <imagedata fileref="kaffeine_configure_tv_isdb_device.png" format="PNG"/>
</imageobject> </imageobject>
 End of changes. 4 change blocks. 
5 lines changed or deleted 81 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)