A Media Player for TDE. Kaffeine source at <ulink url="https://mirror.git.trinitydesktop.org/gitea/TDE/kaffeine">https://mirror.git.trinitydesktop.org/gitea/TDE/kaffeine</ulink>
<para>Kaffeine supports multiple playlists. Choose the active one with the "Playlist" selector. You can easily drag some files or folders from the file browser and drop it on the playlist to enqueue or drop it on the player window to create a new playlist. To change playlist name edit it and confirm with <keycap>Return</keycap>.
</para>
<para>You can find all playlist related functions in the <guimenu>Playlist</guimenu>-Menu and the context-menu (right-click on playlist).
<para>Here you can start Audio CD, DVD or VCD. You can even rip and encode audio tracks to be stored on your hard disk.
</para>
</sect1>
<sect1 id="dvbwindow">
<title>The DVB Window</title>
<screenshot>
<screeninfo>DVB Window</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="dvbwin.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>Kaffeine supports Digital Video Broadcasting devices supported by linuxtv drivers. This window is only visible if Kaffeine find a DVB device at startup. If you have a DVB device and Kaffeine doesn't find it, make sure the driver is loaded and your device recognized. (Further information can be found at www.linuxtv.org)
</para>
<remark>You can arrange your channels in categories. To create a new category, right click in the icon view to get a popup menu. Now, drag a channel name and drop it on the desired category' icon. To remove a channel from a category, drop it on the "All" icon. Right click on an icon to delete that category or change icon.</remark>
<para>You can find all DVB related functions in the <guimenu>DVB</guimenu>-Menu.
</para>
<sect2 id="dvbconfig">
<title>Configuration</title>
<screenshot>
<screeninfo>Configuration</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="dvbconfig.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>Select <guimenu>Menu->DVB->Configure DVB...</guimenu> to open the DVB config dialog. In order to get your device(s) working in Kaffeine, you have to choose a "source" in the list. If you have a DISEqC switch, choose a source for each satellite.
</para>
<para>The <guilabel>Recording</guilabel> page allow you to choose where programs are saved to disk.
</para>
</sect2>
<sect2 id="dvbscan">
<title>Getting channels</title>
<screenshot>
<screeninfo>Channels</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="dvbscan.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>Open the <guilabel>Channels</guilabel> dialog from the <guimenu>DVB</guimenu>-Menu. There, click the <guilabel>Start scan</guilabel> button to start scanning the network for available channels. This can take a while, so be patient ... When done, select the channels you want to add to your channels list and click <guilabel>Add selected</guilabel> or use the filters and click <guilabel>Add filtered</guilabel> (e.g. check "Free to air" and "TV" to add all fta TV).
</para>
<para>When added to channels list, channels are automatically assigned a number. To change this number, right click on the channel name and choose <guilabel>Edit ...</guilabel> from the popup menu. This number will allow you to zap using keypad.
</para>
<remark>Note that you can also change the channel number in the DVB window. Select the channel then click on the number to edit.</remark>
</sect2>
<sect2 id="live">
<title>Viewing live</title>
<screenshot>
<screeninfo>Live TV</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="dvblive.jpg" format="JPEG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>To zap to a channel, you can either double-click on a channel name in the DVB window or use keypad (or remote control with kdelirc) to enter the channel number. Entered digit are displayed in the top left corner of the Player window. You can also hit pageUp/pageDown to zap to previous/next.
</para>
<para>You can now see your favorite program. Kaffeine also displays some informations about this channel using OSD. You can later hit "O" to see it again. (Hit "O" twice to display current program description).
</para>
<para>Now, what if your phone suddenly ring and you absolutely don't want to miss this crucial moment of the movie ? Don't worry. Just hit <guilabel>pause</guilabel>. Kaffeine will pause and immediately start to save the stream to your harddisk. Later, hit <guilabel>play</guilabel> and the program will continue from where you left it. To return to live, just rezap to this channel.
</para>
<remark>Note that live DVB only works with the xine engine (called "Kaffeine"). <guimenu>Menu->Settings->Engine->Kaffeine</guimenu>.</remark>
</sect2>
<sect2 id="epg">
<title>Electronic Program Guide</title>
<screenshot>
<screeninfo>EPG</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="dvbepg.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>
<para><guimenu>Menu->DVB->EPG...</guimenu> brings up the Electronic Program Guide window, displaying current/next programs. Left click on an entry to display the detailed description of the program. Scheduled events for a given channel are displayed when you right click on one of the channel entry and select <guimenu>View all programs</guimenu> from the context menu.
</para>
<para>Double click on an entry to zap to that channel.
</para>
<remark>Note that you have first to zap to some channels in order to get EPG.</remark>
</sect2>
<sect2 id="recording">
<title>Recording</title>
<screenshot>
<screeninfo>Recording</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="dvbtimers.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>Kaffeine offers you several way of recording.
</para>
<para>When you are viewing a live program, you can simply choose <guimenu>Menu->DVB->Instant record</guimenu> to immediately start recording this program. The duration is defined in the <guilabel>Recording</guilabel> page of the DVB config dialog, but you can modify it on the fly from the Timers dialog (<guimenu>Menu->DVB->Timers...</guimenu>). Just select the program and click <guilabel>Edit</guilabel> button to change the duration.
</para>
<para>You can also create a timer from the EPG window. Right click on a program entry and select <guimenu>Add to timers</guimenu> from the context menu. In this case, the timer is created using <guilabel>Begin margin</guilabel> and <guilabel>End margin</guilabel> defined in the <guilabel>Recording</guilabel> page of the DVB config dialog. So, start time is set to [start time given by EPG]-[begin margin] and duration is set to [duration given by EPG]+[begin margin]+[end margin].
</para>
<para>Finally, you can create a new timer by hand. Open the Timers dialog, click on the <guilabel>New</guilabel> button and fill in required informations.
</para>
<para>Note that all timers can be deleted, even if running. Open the Timers dialog, select the program and click the <guilabel>Delete</guilabel> button. Of course, deleting a running timer doesn't delete the file on the disk.
</para>
<remark>You can view and/or record several channels at the same time on the same multiplex. Note that the priority is always given to timers, so if you are viewing a live show and a timer is to be started on a different multiplex, live will be stopped to allow recording.</remark>
<para></para>
<remark>Be aware that a DVB stream is about 1.5GB/hour.</remark>
</sect2>
<sect2 id="replay">
<title>Playing a record</title>
<para>Simply open the file and Kaffeine will start playing. That's all !
<para>Kaffeine can broadcast several DVB channels (being on the same multiplex) on a lan.
</para>
<para>Open the DVB config dialog and go to the <guilabel>Broadcasting</guilabel> page to set address and ports.
</para>
<para><guimenu>Menu->DVB->Broadcasting...</guimenu> opens the broadcasting editor. Select a channel in the <guilabel>Available channels</guilabel> list, and click the <guilabel>Add</guilabel> button to add it to the <guilabel>Broadcasting list</guilabel>. The <guilabel>Available channels</guilabel> list is now filled with channels on the same multiplex. You can now use multi-selection to add channels. Click <guilabel>OK</guilabel> button to start broadcasting.
</para>
<para>To stop broadcasting, open the dialog and click <guilabel>OK</guilabel> with an empty list.
</para>
<remark>Note that the priority is always given to timers, so if you are broadcasting and a timer is to be started on a different multiplex, broadcasting will be stopped to allow recording. And broadcasting has a higher priority than live.</remark>
</sect2>
</sect1>
<sect1 id="dvbclientwindow">
<title>The DVB Client Window</title>
<screenshot>
<screeninfo>DVB Client Window</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="dvbclient.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>To enable DVB client, you have to check the box in the Kaffeine configuration dialog. There you must also set address and ports. It will create a new tab labeled <guilabel>Dvb client</guilabel> showing a list of actually broadcasted channels (if any). Double click on a channel name to start playing it. DVB client also support time shifting (just hit pause).
</para>
</sect1>
</chapter>
<chapter id="player-parts">
<title>Player Parts</title>
<para>You'll find all available player parts in <guimenu>Settings</guimenu>-<guimenuitem>Player Engine</guimenuitem>.
<para>You can use the DCOP interface in two kinds: From inside another application with <function>TDEApplication::dcopClient()->send( "kaffeine", "KaffeineIface", "pause()" )</function>
yet in the (former) bug tracking system at <ulink url="https://bugs.trinitydesktop.org">https://bugs.trinitydesktop.org</ulink>.
Also have a look into the mailinglist archives at <ulink url="https://mail.trinitydesktop.org/mailman3/hyperkitty/list/users@trinitydesktop.org/">https://mail.trinitydesktop.org/mailman3/hyperkitty/list/users@trinitydesktop.org/</ulink>.
To report bugs/issues, please use the upstream development place at the <ulink url="https://mirror.git.trinitydesktop.org/gitea/TDE/kaffeine">TDE Gitea Workspace for Kaffeine</ulink>.
