diff --git a/doc/index.docbook b/doc/index.docbook index da6c144..df821b4 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -1,548 +1,548 @@ Kaffeine"> ]> The &kaffeine; Handbook Jürgen Kofler
kaffeine@gmx.net
 Christophe Thommeret
hftom@free.fr
 Mauro Carvalho Chehab
mchehab+kde@kernel.org
 2004 2016 2017 The &kaffeine; Authors &FDLNotice; 2017-11-11 &kaffeine; 2.0.14 Kaffeine is a Media Player by &kde;. kaffeine vlc video audio mp3 dvd atsc dvb-t dvb-c dvb-s dvb-t2 dvb-s2 isdb-t &kaffeine; Player The Start Window Like many other media players, &kaffeine; supports a wide range of video and audio formats as well as playing audio and video from DVD and &CD;. Additionally, it supports live Digital TV playback if your machine has a Digital Video Broadcast (DVB) device plugged into it. Once &kaffeine; starts, it presents a screen with the main functions in the middle, and it’s possible to switch to other functions via either the pop up menu or the lateral menu: Start Window Start Window Play a File Playing a video or audio file is as simple as clicking on the Play File button. It will ask you to select the file to be played, and will begin playing it. Since &kaffeine; uses LibVLC for the backend, it supports all the same file formats as VLC. It also supports opening a list of files to create and manage playlists. Play a File Play a File The Playlist Window &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 a playlist name edit it and confirm with Return. Playlist Window Playlist Window You can find all playlist related functions in the Playlist-Menu and the context-menu (right-click on playlist). Digital TV Player Digital TV configuration While the basic functionality is useful enough for someone who wants a simple, yet powerful media player, the best feature in &kaffeine; is to use it as a &GUI; frontend to watch and record digital TV. Since &kaffeine; version 2.0, the digital TV support uses libdvbv5 and was extended to support new standards like DVB-T2 and ISDB-T. Extending its support for newer digital TV standards is now simpler. Also, since it uses the &Linux; DVB version 5 API, it supports frontends capable of implementing multiple digital TV standards. Setting the TV configuration on &kaffeine; is as simple as clicking on the Television pop up menu, and selecting the Configure Television option. A pop up window will open, allowing setting the parameters to be used: TV Configuration - General Options TV Configuration - General Options General digital TV settings The General Options menu allows setting the device-independent settings. The Recording folder sets the location where all TV program records will be stored. The Time shift folder is used in conjunction with the pause button () of the media player screen. When the button is pressed, a time shift file will be stored at the location pointed by this menu option. The Begin margin and End margin options are used to setup a sort of security margin in order to avoid losing the beginning and the end of a program, as the time stamps at the program guide may not be precise. So, it actually starts recording a few -minutes before the Start time defined at the +minutes before the Start time defined in the Program Guide. The exact amount of time before is defined via Begin margin. It extends the record by the amount of time defined by End margin. after the end of the program. The Naming style for recordings is used to setup how &kaffeine; will name a program. Several macros can be used to dynamically change the name of the record: %title - Title of the program, as seen at the Program Guide and Recording Schedule menus; %day, %month, %year, %hour, %min, %sec - Fields from the time stamp with represents the time when &kaffeine; starts recording a program; %channel - Name of the channel that streamed the program. The Action after recording finishes option is used to setup an optional command to be executed when &kaffeine; stops recording a program. Cliking at the Update Scan Data over Internet option makes &kaffeine; to check if a new channel scanning definition file is present at KDE's site. &kaffeine; uses a file called scanfile.dvb with stores a list of known digital TV channels per Country and City. This file is kept in sync with the contents of the dtv-scan-tables tree, maintained by LinuxTV community. For more details, please see the dtv-scan-tables wiki page. When the button is clicked, &kaffeine; will download the latest version of the channel definitions and store on a user-specific local data file, overriding any contents of a previous one. Please notice that, in order to use the newest definitions, it is required to close the TV configuration dialog and reopen. The Edit scanfile option allows editing the file, with can be useful to add a new set of channels, while the upstream file is not updated. If you need to use it, please consider sending an update to dtv-scan-tables - for others to also benefit for the new channel definitions. + for others to also benefit from the new channel definitions. The Use ISO 8859-1 charset instead of ISO 6937 -option allows to select the default to be used on MPEG-TS messages +option allows selecting the default to be used on MPEG-TS messages that don't explicitly set a charset. If not set, it defaults to using ISO-6937 encoding. If set, the default changes to ISO 8859-1. The Create info files to accompany EPG recordings -option enables the creation of an 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 Program guide. Configuring digital TV sources TV Device Configuration TV Configuration The Device menus have the per-device setup. Usually selecting the country and the city in the Source combo box (or using one of the Autoscan sources) is enough for non-satellite configurations. The same happens for devices that support multiple TV standards: Digital TV channel setup Channel Configuration Channel Configuration After clicking on the Ok button, the next step is to scan for the digital channels, using the Television pop up menu, option Channels: Scanning Channels Scanning Channels If more then one standard is supported, the Source combo box will allow you to select the one that will be used to scan. Don't forget to connect the device's antenna cable to match the standard that will be used. When &kaffeine; identifies a channel, it reads a MPEG-TS table called Network Information Table (NIT), with contains information about channels using different tuning parameters transmitted by the same broadcaster. On certain networks, it is possible that some tuning parameters to be stored on several NIT tables (called other NITs). This is more common on some cable and satellite systems. By selecting Search transponders for other Networks, &kaffeine; is instructed to wait and parse all other NITs, with may make it to find more channels, at the cost of taking a lot more time to complete the channel scan operation. -The channel scan operation is started by clicking at +The channel scan operation is started by clicking on Start Scan. Once finished, the discovered channels will appear on the right. These channels can be copied to the left side by clicking Add Filtered. It is possible to check the tuning parameters for the channel in the left side by clicking on the Edit button. Some parameters are adjustable in the window that pops up. Edit Channel Settings Edit Channel Settings Once the channels are saved, watching TV is as simple as clicking on the Digital TV button in the main window: Watching TV Watching TV Watching TV &kaffeine; also allows you to click on the to pause it. When the button is clicked, &kaffeine; will record the program and once the button is pressed it will start the program from the point it was paused. There is also a button that allows you to quick record and save the program to disk. Program Guide Digital TV channels usually transmit a list of the current and future attractions. This is called Electronic Program Guide - EPG. The EPG data is captured when a channel's content is played. To see the EPG, open the Television pop up menu and select the Program Guide option: Program Guide Program Guide -On some Countries, the EPG may be availabe on multiple languages. By +On some Countries, the EPG may be available in multiple languages. By default, &kaffeine; shows any languages on EPG. If multiple languages are available for a given EPG entry, and no explicit language content is select, it will prefix the title, subtitle and description data with a 3 -code language code, as defined by ISO 639-2 specification. +letter language code, as defined by ISO 639-2 specification. -The EPG Language option allows to filter just one +The EPG Language option allows filtering just one language. If enabled, the filter will also be applied to the On Screen Display - OSD and to any new scheduled recordings. It won't affect pre-existing scheduled recordings. Besides clicking on the record button -when the live view is opened, &kaffeine; also allows to record a program +when the live view is opened, &kaffeine; also allows recording a program via the program guide, by clicking on the Record Show at the Program Guide window. Recording Schedule To see the programs that are scheduled to be recorded, open the Television pop up menu and select the Recording Schedule option: Recording Schedule Recording Schedule By clicking one the New button, it is possible to directly define a time and duration for a program to be recorded. In this case, it won't use the EPG definitions. -By selecting an existing program and clicking at the +By selecting an existing program and clicking on the Edit button, you may change the start time and the record duration. You may also program it to be recorded weekly or daily. -By selecting an existing program and clicking at the +By selecting an existing program and clicking on the Remove button, it will remove the program from the recording schedule. Copyright and License Program copyright 2007-2017, The &kaffeine; Authors Documentation copyright 2003-2005, Jürgen Kofler kaffeine@gmx.net, Christophe Thommeret hftom@free.fr, Mauro Carvalho Chehab mchehab+kde@kernel.org &underFDL; &underGPL; &documentation.index;