kfile(1) A commandline tool to read and modify metadata of files


kfile [Qt-options] [KDE-options] [options] [files]


This manual page documents briefly the kfile command.

kfile is a commandline tool to read and modify metadata of files.


This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

Show author information.
Show help about options.
Show all options.
Show KDE specific options.
Show Qt specific options.
Show license information.
-v, --version
Show version information.


--bg, --background color
Sets the default background color and an application palette (light and dark shades are calculated).
--btn, --button color
Sets the default button color.
Causes the application to install a private color map on an 8-bit display.
--display displayname
Use the X-server display 'displayname'.
Running under a debugger can cause an implicit --nograb, use --dograb to override.
--fg, --foreground color
Sets the default foreground color.
--fn, --font fontname
Defines the application font.
--im XIMserver
Set XIM server.
--inputstyle inputstyle
Sets XIM (X Input Method) input style. Possible values are onthespot, overthespot, offthespot and root.
--name name
Sets the application name.
--ncols count
Limits the number of colors allocated in the color cube on an 8-bit display, if the application is using the QApplication::ManyColor color specification.
Tells Qt to never grab the mouse or the keyboard.
Disable XIM.
Mirrors the whole layout of widgets.
--session sessionId
Restore the application for the given 'sessionId'.
Switches to synchronous mode for debugging.
--title title
Sets the application title (caption).
--visual TrueColor
Forces the application to use a TrueColor visual on an 8-bit display.


--caption caption
Use 'caption' as name in the titlebar.
--config filename
Use alternative configuration file.
--dcopserver server
Use the DCOP Server specified by 'server'.
--geometry geometry
Sets the client geometry of the main widget.
--icon icon
Use 'icon' as the application icon.
--miniicon icon
Use 'icon' as the icon in the titlebar.
Disable crash handler, to get core dumps.
--style style
Sets the application GUI style.
Waits for a WM_NET compatible windowmanager.


--av, --allValues
Prints all metadata values, available in the given file(s).
Opens a KDE properties dialog to allow viewing and modifying of metadata of the given file(s).
--getValue key
Prints the value for 'key' of the given file(s). 'key' may also be a comma-separated list of keys.
--la, --listavailable
List all metadata keys which have a value in the given file(s).
--lp, --listpreferred mimetype
List all preferred metadata keys of the given file(s). If mimetype is not specified, the mimetype of the given files is used.
--ls, --listsupported mimetype
List all supported metadata keys of the given file(s). If mimetype is not specified, the mimetype of the given files is used.
-m, --nomimetype
Print the mimetype of the given file(s).
--pv, --preferredValues
Prints the preferred metadata values, available in the given file(s).
-q, --quiet
Don't print a warning when more than one file was given and they don't have all the same mimetype.
--setValue key=value
Attempts to set the value 'value' for the metadata key 'key' for the given file(s).
--sm, --supportedMimetypes
Prints all mimetypes for which metadata support is available.


This manual page was written by Chris Cheney <[email protected]> for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.