'\" t .\" Title: \fBKaffeine\fR .\" Author: Burkhard Lück .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2018-05-01 .\" Manual: Kaffeine User's Manual .\" Source: Kaffeine 2.0.15 .\" Language: English .\" .TH "\FBKAFFEINE\FR" "1" "2018\-05\-01" "Kaffeine 2.0.15" "Kaffeine User's Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" kaffeine \- A media player by KDE with digital TV support .SH "SYNOPSIS" .HP \w'\fBkaffeine\fR\ 'u \fBkaffeine\fR [\fB\-d,\ \-\-debug\fR] [\fB\-\-tempfile\fR] [\fB\-f,\ \-\-fullscreen\fR] [\fB\-m,\ \-\-minimal\fR] [\fB\-t,\ \-\-alwaysontop\fR] [\fB\-\-audiocd\fR] [\fB\-\-videocd\fR] [\fB\-\-aspectratio\ \fR\fB\fIaspect_ratio\fR\fR] [\fB\-\-dvd\fR] [\fB\-\-dumpdvb\fR] [\fB\-\-channel\ \fR\fB\fIname\fR\fR\fB\ /\ \fR\fB\fInumber\fR\fR] [\fB\-\-tv\ \fR\fB\fIchannel\fR\fR] [\fB\-\-lastchannel\fR] [\fB\fIfiles\fR\fR] .PP Please notice that \fB\-\-channel\fR, \fB\-\-tv\fR, \fB\-\-lastchannel\fR, \fB\-\-audiocd\fR, \fB\-\-videocd\fR, \fB\-\-dvd\fR and \fB\fIfiles\fR\fR are mutually exclusive\&. .SH "DESCRIPTION" .PP Kaffeine is a media player\&. What makes it different from the others is its excellent support of digital TV (DVB)\&. Kaffeine has user\-friendly interface, so that even first time users can start immediately playing their movies: from DVD (including DVD menus, titles, chapters, etc\&.), VCD, or a file\&. .PP Kaffeine uses libVLC as video/audio play backend\&. .SH "OPTIONS" .PP \fB\-d\fR \fB\-\-debug\fR .RS 4 Enable all debug messages\&. Please notice that Kaffeine also allows fine\-tuning debug messages, by enabling messages per category, by using the environment var: .sp \fB QT_LOGGING_RULES=kaffeine\&.\fR\fB\fIcategory\fR\fR\fB\&.debug=true \fR .sp where \fIcategory\fR can be: .PP \fBcam\fR .RS 4 for dvb CAM logs .RE .PP \fBdev\fR .RS 4 for dvb device and libdvbv5 logs .RE .PP \fBdvbsi\fR .RS 4 for dvb MPEG\-TS SI parsing logs .RE .PP \fBepg\fR .RS 4 for dvb EPG logs .RE .PP \fBdvb\fR .RS 4 for other dvb logs .RE .PP \fBconfig\fR .RS 4 for configuration logs .RE .PP \fBmediawidget\fR .RS 4 for media widget logs .RE .PP \fBplaylist\fR .RS 4 for playlist logs .RE .PP \fBsql\fR .RS 4 for SQL lite logs .RE .PP \fBvlc\fR .RS 4 for libVlc logs .RE .RE .PP \fB\-\-tempfile\fR .RS 4 The files/URLs opened by the application will be deleted after use .RE .PP \fB\-f\fR \fB\-\-fullscreen\fR .RS 4 Start in full screen mode\&. When in full screen mode, all menus are hidden by default\&. In order to unhide the menus, move the mouse to the menu locations, e\&. g\&. to the top/bottom or left position of the screen\&. .RE .PP \fB\-m\fR \fB\-\-minimal\fR .RS 4 Start in minimal mode\&. In minimal mode, the window decoration with the title bar is shown\&. All other menus are hidden by default\&. In order to unhide the menus, move the mouse to the menu locations, e\&. g\&. to the top/bottom or left position of the Kaffeine window\&. .sp Starts in minimal mode .RE .PP \fB\-t\fR \fB\-\-alwaysontop\fR .RS 4 Tells the window manager to start Kaffeine main window always on top of other windows\&. This option can be disabled later via the window manager, usually by clicking the title bar with the right mouse button and deselecting the always on top button box\&. .RE .PP \fB\-\-aspectratio\fR \fIaspect_ratio\fR .RS 4 Forces Kaffeine to start with an specific aspect ratio, disabling the automatic mode\&. This can be useful on wide and ultra\-wide monitors, where the user always want to see video in full screen mode using the maximum possible resolution\&. Valid values are: 1:1, 4:3, 5:4, 16:9, 16:10, 2\&.21:1, 2\&.35:1 and 2\&.39:1\&. If an invalid value is passed, or if this option is not used, it will default to automatic mode\&. .RE .PP \fB\-\-audiocd\fR .RS 4 Play Audio CD .RE .PP \fB\-\-videocd\fR .RS 4 Play Video CD .RE .PP \fB\-\-dvd\fR .RS 4 Play DVD .RE .PP \fB\-\-dumpdvb\fR .RS 4 Dump dvb data (debug option) .RE .PP \fB\-\-channel\fR \fIname\fR / \fInumber\fR .RS 4 Play TV channel .RE .PP \fB\-\-tv\fR \fIchannel\fR .RS 4 (deprecated option) .RE .PP \fB\-\-lastchannel\fR .RS 4 Play last tuned TV channel .RE .PP \fB\fIfiles\fR\fR .RS 4 Files or URLs to play .RE .SH "FILES" .PP Kaffeine uses the file scanfile\&.dvb with a list of known channels per locality and per Satellite (for DVB\-S)\&. .PP When either new channels are added on some City, or when new Satellite beams are added, which are not available in Kaffeine, either use dvbv5\-scan or w_scan to generate a new file (in the latter case, converted to the proper format using dvb\-format\-convert), and submit it to , with the subject \(lq[PATCH] dtv\-scan\-tables: \fIsome description\fR\(rq\&. The new patch will be added to scanfile\&.dvb and the updated file will be available to be updated from the Internet in the Kaffeine application\&. .SH "SEE ALSO" .RS 4 More detailed user documentation is available from \m[blue]\fBhelp:/kaffeine\fR\m[]\&\s-2\u[1]\d\s+2 (either enter this URL into Konqueror, or run \fB\fBkhelpcenter\fR\fR\fB \fR\fB\fIhelp:/kaffeine\fR\fR)\&. .RE .RS 4 kf5options(7) .RE .RS 4 qt5options(7) .RE .RS 4 dvbv5\-scan(1) .RE .RS 4 w\-scan(1) .RE .RS 4 There is also further information available at the \m[blue]\fBKaffeine Page\fR\m[]\&\s-2\u[2]\d\s+2 .RE .SH "AUTHORS" .PP To list the authors of Kaffeine use \fB\fBkaffeine\fR\fR\fB \fR\fB\fB\-\-author\fR\fR in a terminal\&. .SH "AUTHOR" .PP \fBBurkhard Lück\fR <\&lueck@hube\-lueck\&.de\&> .RS 4 Author. .RE .SH "NOTES" .IP " 1." 4 help:/kaffeine .RS 4 \%help:/kaffeine .RE .IP " 2." 4 Kaffeine Page .RS 4 \%https://www.kde.org/applications/multimedia/kaffeine/ .RE