KAFFEINE(1)

💖 KAFFEINE(1) — the Kaffeine User's Manual, but make it make sense 💖

okay bestie, so this is the manual page for kaffeine — a media player by KDE with digital TV support — and I'm gonna walk you through every single flag like we're texting at 2am. no detail left behind. periodt. 🫶

✨ NAME ✨

kaffeine — A media player by KDE with digital TV support

🌈 SYNOPSIS 🌈

kaffeine [-d, --debug] [--tempfile] [-f, --fullscreen] [-m, --minimal]
         [-t, --alwaysontop] [--audiocd] [--videocd]
         [--aspectratio aspect_ratio] [--dvd] [--dumpdvb]
         [--channel name / number] [--tv channel] [--lastchannel]
         [files]

🚨 real talk, bestie: please notice that --channel, --tv, --lastchannel, --audiocd, --videocd, --dvd and files are mutually exclusive. pick one vibe. you cannot serve all of these at the same time, it's giving chaos. 💀

🌸 DESCRIPTION 🌸

Kaffeine is a media player. What makes it different from the others is its excellent support of digital TV (DVB). iconic, honestly. Kaffeine has a 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. like, no tutorial needed, you just press play and go 💅

Kaffeine uses libVLC as video/audio play backend. that's the engine, bestie.

✨ OPTIONS ✨

• -d, --debug — Enable all debug messages. heads up: Kaffeine also allows fine-tuning debug messages, by enabling messages per category, by using the environment var:

QT_LOGGING_RULES=kaffeine.category.debug=true

where category can be:

• cam — for dvb CAM logs
• dev — for dvb device and libdvbv5 logs
• dvbsi — for dvb MPEG-TS SI parsing logs
• epg — for dvb EPG logs
• dvb — for other dvb logs
• config — for configuration logs
• mediawidget — for media widget logs
• playlist — for playlist logs
• sql — for SQL lite logs
• vlc — for libVlc logs

• --tempfile — The files/URLs opened by the application will be deleted after use. so like… be careful, she's gone after this 🫣
• -f, --fullscreen — 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. it's giving immersive cinema energy ✨
• -m, --minimal — 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.

Starts in minimal mode

(yes bestie, the original says "starts in minimal mode" twice. I'm not gonna gatekeep that from you, so here it is again. it's redundant but it's canon. 💜)

• -t, --alwaysontop — 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. main character energy, always front and center 👑
• --aspectratio aspect_ratio — 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. ultrawide girlies, this one's for you 🦋
• --audiocd — Play Audio CD 💿
• --videocd — Play Video CD 📀
• --dvd — Play DVD 🎬
• --dumpdvb — Dump dvb data (debug option) 🛠️
• --channel name / number — Play TV channel 📺
• --tv channel — (deprecated option) ⚠️ like, it's still here but she's retired, yk?
• --lastchannel — Play last tuned TV channel 🔁
• files — Files or URLs to play 🍓

🎀 FILES 🎀

Kaffeine uses the file scanfile.dvb with a list of known channels per locality and per Satellite (for DVB-S).

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 <linux-media@vger.kernel.org>, with the subject “[PATCH] dtv-scan-tables: some description”. 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. contributing to open source?? we LOVE to see it 🌈

👑 SEE ALSO 👑

• More detailed user documentation is available from help:/kaffeine[1] (either enter this URL into Konqueror, or run khelpcenter help:/kaffeine).
• kf5options(7)
• qt5options(7)
• dvbv5-scan(1)
• w-scan(1)
• There is also further information available at the Kaffeine Page[2]

💜 AUTHORS 💜

To list the authors of Kaffeine use kaffeine --author in a terminal. go on, give them their flowers 💐

💅 AUTHOR 💅

Burkhard Lück <lueck@hube-lueck.de>

• Author.

🔥 NOTES 🔥

1. help:/kaffeine help:/kaffeine
2. Kaffeine Page https://www.kde.org/applications/multimedia/kaffeine/

okay that's the whole thing, you made it to the end, I'm so proud 🥹

Kaffeine 2.0.15 — dated 2018-05-01 — and that's the vibe check, complete. slay, bestie, go watch something ✨💖🦋