KDE Frameworks is a collection of libraries and software frameworks readily available to any Qt-based software stacks or applications on multiple operating systems. Featuring frequently needed functionality solutions like hardware integration, file format support, additional graphical control elements, plotting functions, and spell checking, the collection serves as technological foundation for KDE Plasma 5 and KDE Gear distributed under the GNU Lesser General Public License (LGPL).
|Initial release||1 July 2014|
5.94.0 / 14 May 2022
|Written in||C++ (Qt)|
|Operating system||Cross-platform (including "partial" support for Android, Windows, macOS and Haiku)|
|License||GNU Lesser General Public License (LGPL)|
Since the split of the KDE Software Compilation into KDE Frameworks 5, KDE Plasma 5 and KDE Applications, each sub-project can pick its own development pace. KDE Frameworks are released on a monthly basis and use git.
It should be possible to install KDE Frameworks alongside the KDE Platform 4 so apps can use either one.
API and ABI stabilityEdit
Platform releases are those which begin a series (version number X.0). Only these major releases are allowed to break binary compatibility with the predecessor. Releases in the minor series (X.1, X.2, ...) will guarantee binary portability (API & ABI). This means, for instance, that software that was developed for KDE 3.0 will work on all (future) KDE 3 releases; however, an application developed for KDE 2 is not guaranteed to be able to make use of the KDE 3 libraries. KDE major version numbers mainly follow the Qt release cycle, meaning that KDE SC 4 is based on Qt 4, while KDE 3 was based on Qt 3.
Supported operating systemsEdit
The repository of each framework should contain a file named metainfo.yaml. This file documents the maintainer of the framework, the type, the supported operating system and other information. The currently supported platforms are Linux, Microsoft Windows, macOS and Android.
This section needs to be updated.(October 2021)
The Frameworks have a clear dependency structure, divided into "categories" and "tiers". The "categories" refer to runtime dependencies:
- Functional elements have no runtime dependencies.
- Integration designates code that may require runtime dependencies for integration depending on what the OS or platform offers.
- Solutions have mandatory runtime dependencies.
The KDE Frameworks bundle consists of over 70 packages. These existed as a single large package, called kdelibs, in KDE SC 4. Kdelibs was split into several individual frameworks, some of which are no longer part of KDE but were integrated into Qt 5.2.
- Tiers of Frameworks
- Tier 1 - Mostly depend only on Qt, highly portable
- Tier 2 - Depend on Tier 1, but dependencies are still manageable
- Tier 3 - Complex dependencies, including Tiers 1-2 etc.
- Tier 4 - Mostly plugins that provide additional features like platform support; can be ignored
|Frameworkintegration||4||frameworkintegration.git Archived 2017-12-28 at the Wayback Machine||Framework Integration is a set of plugins responsible for better integration of Qt applications when running on a KDE Plasma workspace. Applications do not need to link to this directly. The library KF5Style provides integration with KDE Plasma Workspace settings for Qt styles. Derive your Qt style from KStyle to automatically inherit various settings from the KDE Plasma Workspace, providing a consistent user experience. For example, this will ensure a consistent single-click or double-click activation setting, and the use of standard themed icons.|
|KActivities||3||kactivities.git Archived 2017-12-25 at the Wayback Machine||Core components for KDE Activities' Activity Manager.|
|KApiDox||4||kapidox.git Archived 2017-12-25 at the Wayback Machine||Scripts and data for building API documentation in a standard format and style. This framework contains scripts and data for building API documentation (dox) in a standard format and style. The Doxygen tool is used to do the actual documentation extraction and formatting, but this framework provides a wrapper script to make generating the documentation more convenient (including reading settings from the target framework or other module) and a standard template for the generated documentation.|
|KArchive||1||karchive.git Archived 2017-10-17 at the Wayback Machine||Classes for easy reading, creation and manipulation of "archive" formats including zip and tar.|
|KAuth||2||kauth.git Archived 2017-08-21 at the Wayback Machine||Provides a convenient, system-integrated way to offload actions that need to be performed as a privileged user to small helper utilities.|
|KBookmarks||3||kbookmarks.git Archived 2017-12-28 at the Wayback Machine||KBookmarks lets you access and manipulate bookmarks stored using the "XBEL format". The most common use for bookmarks is web browsers, but this can also be useful in any application where local files or URLs can be saved as bookmarks.|
|KCMUtils||3||kcmutils.git Archived 2017-12-25 at the Wayback Machine||Utilities, i.a. KSettings, for KDE System Settings modules. KCMUtils provides various classes to work with KCModules. KCModules can be created with the KConfigWidgets framework.|
|KCodecs||1||kcodecs.git Archived 2017-12-28 at the Wayback Machine||KCodecs is a string encoding library, it provides a collection of methods to manipulate strings using various encodings. It can automatically determine the charset of a string, translate XML entities, validate email addresses, and find encodings by name in a more tolerant way than QTextCodec (useful e.g. for data coming from the Internet).|
|KCompletion||2||kcompletion.git Archived 2018-01-16 at the Wayback Machine||String completion framework, including completion-enabled lineedit and combobox. When typing filenames, email addresses and other text where the user often wants to select from existing data (including what they previously typed) rather than enter anything wholly original, users often find it helpful if they only need to type the first few characters, and then have the application offer them a set of choices or attempt to finish off what they were typing. Email clients, shells and "open file" dialogs often provide this functionality. This framework helps implement this in Qt-based applications. You can use one of the completion-ready widgets provided by this framework, or integrate it into your application's other widgets directly. |
The easiest way to get started is to use a KComboBox, KHistoryComboBox or KLineEdit. If you want to integrate completion into other parts of the user interface, you can use KCompletion to manage and select the possible completions.
|KConfig||1||kconfig.git Archived 2017-12-25 at the Wayback Machine||Persistent platform-independent application settings made of two parts: KConfigCore and KConfigGui.|
KConfigCore provides access to the configuration files themselves, meaning it also generates the configuration in XML.
KConfigGui provides a way to hook graphical control elements (widgets) to the configuration so that they are automatically initialized from the configuration and automatically propagate their changes to their respective configuration files.
|KConfigWidgets||3||kconfigwidgets.git Archived 2019-01-30 at the Wayback Machine||Graphical control elements (widgets) for configuration dialogs. Widgets for configuration dialogs. KConfigWidgets provides easy-to-use classes to create configuration dialogs, as well as a set of widgets which uses KConfig to store their settings.|
|KCoreAddons||1||kcoreaddons.git Archived 2017-12-25 at the Wayback Machine||Utilities for core application functionality and accessing the OS. Qt addon library with a collection of non-GUI utilities. KCoreAddons provides classes built on top of QtCore to perform various tasks such as manipulating mime types, autosaving files, creating backup files, generating random sequences, performing text manipulations such as macro replacement, accessing user information and many more.|
|KCrash||2||kcrash.git Archived 2019-01-31 at the Wayback Machine||Provides support for intercepting and handling application crashes.|
|KDBusAddons||1||kdbusaddons.git Archived 2017-12-25 at the Wayback Machine||KDBusAddons provides convenience DBus classes on top of QtDBus, as well as an API to create KDED modules.|
|KDeclarative||3||kdeclarative.git Archived 2017-12-28 at the Wayback Machine||Addon for Qt declarative|
|KDED||3||kded.git Archived 2019-01-30 at the Wayback Machine||KDED stands for KDE Daemon, the central daemon of KDE work spaces. KDED runs in the background and performs a number of small tasks. Some of these tasks are built in, others are started on demand.|
|KDesignerPlugin||3||kdeclarative.git Archived 2017-12-28 at the Wayback Machine||This framework provides plugins for Qt Designer that allow it to display the widgets provided by various KDE frameworks, as well as a utility (kgendesignerplugin) that can be used to generate other such plugins from ini-style description files.|
|KDESu||3||kdesu.git Archived 2017-12-25 at the Wayback Machine||KDESU (KDE super user) provides a user interface for running shell commands with root privileges. It provides functionality for building GUI front ends for (password asking) console mode programs. For example, kdesu and kdessh use it to interface with su and ssh respectively.|
|KDEWebkit||3||kdewebkit.git Archived 2017-12-25 at the Wayback Machine||Integration of the HTML rendering engine WebKit. The KDEWebkit library provides KDE integration of the QtWebKit library. If you are using QtWebKit in your KDE application, you are encouraged to use this layer instead of using the QtWebKit classes directly. In particular, you should use KWebView in place of QWebView, KGraphicsWebView in place of QGraphicsWebView and KWebPage in place of QWebPage.|
|KDNSSDFramework||2||kdnssd.git Archived 2017-12-25 at the Wayback Machine||KDNSSD is a library for handling the DNS-based Service Discovery Protocol (DNS-SD), the layer of [Zeroconf] (http://www.zeroconf.org) that allows network services, such as printers, to be discovered without any user intervention or centralized infrastructure.|
|KDocTools||2||kdoctools.git Archived 2017-12-28 at the Wayback Machine||Provides tools to generate documentation in various format from DocBook files.|
|KEmoticons||3||kemoticons.git Archived 2017-12-25 at the Wayback Machine||Provides emoticons themes as well as helper classes to automatically convert text emoticons to graphical emoticons.|
|KGlobalAccel||1||kglobalaccel.git Archived 2019-02-02 at the Wayback Machine||KGlobalAccel allows you to have global keyboard shortcuts (accelerators) that are independent of the focused window. Unlike regular shortcuts, the application's window does not need focus for them to be activated.|
|KGuiAddons||1||kguiaddons.git Archived 2017-12-28 at the Wayback Machine||KDE GUI Addons; Utilities for graphical user interfaces; The KDE GUI addons provide utilities for graphical user interfaces in the areas of colors, fonts, text, images, keyboard input.|
|Ki18n||1||ki18n.git Archived 2017-12-25 at the Wayback Machine||KDE gettext-based UI text internationalization. KI18n provides functionality for internationalizing user interface text in applications, based on the GNU Gettext translation system. It wraps the standard Gettext functionality, so that the programmers and translators can use the familiar Gettext tools and workflows. KI18n provides additional functionality as well, for both programmers and translators, which can help to achieve a higher overall quality of source and translated text. This includes argument capturing, customizable markup, and translation scripting.|
|KIconThemes||3||kiconthemes.git Archived 2017-12-24 at the Wayback Machine||This library contains classes to improve the handling of icons in applications using the KDE Frameworks.|
|KIdleTime||1||kidletime.git Archived 2017-12-28 at the Wayback Machine||Integration module for idle time detection.|
|KImageFormats||1||kimageformats.git Archived 2017-12-28 at the Wayback Machine||Plugins to allow QImage to support extra file formats. This framework provides additional image format plugins for QtGui. As such it is not required for the compilation of any other software, but may be a runtime requirement for Qt-based software to support certain image formats.|
The following image formats have read-only support:
The following image formats have read and write support:
|KInit||3||kinit.git Archived 2017-12-25 at the Wayback Machine||kdeinit is a process launcher, that launches processes by forking and then loading a dynamic library which should contain a 'kdemain(...)' function. kdeinit speeds up start of applications on KDE workspaces; kdeinit is linked against all libraries a standard KDE application needs. With this technique starting an application becomes much faster because now only the application itself needs to be linked whereas otherwise both the application as well as all the libraries it uses need to be linked.|
|KIO||3||kio.git Archived 2017-04-05 at the Wayback Machine||Network transparent access to files and data. This framework implements almost all the file management functions you will ever need. Dolphin and the KDE file dialog also uses this to provide its network-enabled file management.|
|Kirigami||1||kirigami.git Archived 2017-12-28 at the Wayback Machine||A set of QtQuick plugins to build user interfaces based on the KDE UX guidelines|
|KItemModels||1||kitemmodels.git Archived 2017-12-28 at the Wayback Machine||Set of item models extending the Qt model-view framework. KItemModels provides the following models:
|KItemViews||1||kitemviews.git Archived 2017-12-24 at the Wayback Machine||Set of item views extending the Qt model-view framework. KItemViews includes a set of views, which can be used with item models. It includes views for categorizing lists and to add search filters to flat and hierarchical lists.|
|KJobWidgets||2||kjobwidgets.git Archived 2017-12-25 at the Wayback Machine||KJobWIdgets provides widgets for showing progress of asynchronous jobs.|
|KMediaPlayer||3||kmediaplayer.git Archived 2017-12-28 at the Wayback Machine||Deprecated: Interface for media player KParts. KMediaPlayer builds on the KParts framework to provide a common interface for KParts that can play media files. This framework is a porting aid. It is not recommended for new projects, and existing projects that use it are advised to port away from it, and use plain KParts instead.|
|KNewStuff||3||knewstuff.git Archived 2017-12-28 at the Wayback Machine||Framework for downloading and sharing additional application data. The KNewStuff library implements collaborative data sharing for applications. It uses libattica to support the Open Collaboration Services specification.|
Attica Archived 2017-12-28 at the Wayback Machine is a Qt library that implements the Open Collaboration Services API version 1.6. It grants easy access to the services such as querying information about persons and contents.
|KNotifications||3||knotifications.git Archived 2017-12-28 at the Wayback Machine||Solution with abstraction for system notifications.|
|KNotifyConfig||3||knotifyconfig.git Archived 2017-12-28 at the Wayback Machine||Module for KNotify configuration.|
|KParts||3||kparts.git Archived 2017-12-28 at the Wayback Machine||The KParts library implements the framework for KDE parts. One individual user interface component is called a KPart and is some elaborate widget with a user-interface defined in terms of actions (menu items, toolbar icons). KParts are analogous to Bonobo components in GNOME and ActiveX controls in Microsoft's Component Object Model. Konsole is available as a KPart and is used in applications like Konqueror and Kate. Example uses of KParts:
|KPlotting||1||kplotting.git Archived 2019-01-31 at the Wayback Machine||KPlotWidget is a QWidget-derived class that provides a virtual base class for easy data-plotting. The idea behind KPlotWidget is that you only have
to specify information in "data units"; i.e., the natural units of the data being plotted. KPlotWidget automatically converts everything to screen pixel units. KPlotWidget draws X and Y axes with tick marks and tick labels. It automatically determines how many tick marks to use and where they should be, based on the data limits specified for the plot. You change the limits by calling `setLimits(double x1, double x2, double y1, double y2)`. Data to be plotted are stored using the KPlotObject class. KPlotObject consists of a QList of QPointF's, each specifying the X,Y coordinates of a data point. KPlotObject also specifies the "type" of data to be plotted (POINTS or CURVE or POLYGON or LABEL).
|KPty||2||kpty.git Archived 2019-01-31 at the Wayback Machine||Interfacing with pseudo terminal devices. This library provides primitives to interface with pseudo terminal devices as well as a KProcess derived class for running child processes and communicating with them using a pty.|
|Kross||3||kross.git Archived 2017-12-28 at the Wayback Machine||Embedding of scripting into applications. Kross is a scripting bridge to embed scripting functionality into an application. It supports QtScript as a scripting interpreter back-end.|
The core of Kross provides the framework to deal transparently with interpreter-back-ends and offers abstract functionality to deal with scripts.
|KRunner||3||krunner.git Archived 2017-12-23 at the Wayback Machine||Framework for providing different actions given a string query. Framework for Plasma runners. The Plasma workspace provides an application called KRunner which, among other things, allows one to type into a text area which causes various actions and information that match the text appear as the text is being typed. One application for this is the universal runner you can launch with ALT+F2.|
|KService||3||kservice.git Archived 2017-12-28 at the Wayback Machine||KService provides a plugin framework for handling desktop services. Services can be applications or libraries. They can be bound to MIME types or handled by application specific code.|
|KSyntaxHighlighting||1||syntax-highlighting.git Archived 2019-01-31 at the Wayback Machine||This is a stand-alone implementation of the Kate syntax highlighting engine. It's meant as a building block for text editors as well as for simple highlighted text rendering (e.g. as HTML), supporting both integration with a custom editor as well as a ready-to-use QSyntaxHighlighter sub-class.|
|KTextEditor||3||ktexteditor.git Archived 2018-12-10 at the Wayback Machine||KTextEditor provides a powerful text editor component that you can embed in your application, either as a KPart or using the KF5::TextEditor library (if you need more control). The text editor component contains many useful features, from syntax highlighting and automatic indentation to advanced scripting support, making it suitable for everything from a simple embedded text-file editor to an advanced IDE.|
|KTextWidgets||3||ktextwidgets.git Archived 2017-12-28 at the Wayback Machine||KTextWidgets provides widgets for displaying and editing text. It supports rich text as well as plain text.|
|KUnitConversion||2||kunitconversion.git Archived 2017-12-28 at the Wayback Machine||KUnitConversion provides functions to convert values in different physical units. It supports converting different prefixes (e.g. kilo, mega, giga) as well as converting between different unit systems (e.g. liters, gallons). The following areas are supported:
|KWalletFramework||3||kwallet.git Archived 2017-12-25 at the Wayback Machine||Safe desktop-wide storage for passwords. This framework contains two main components:
|KWayland||1||kwayland.git Archived 2019-01-31 at the Wayback Machine||KWayland is the KDE library for implementing Wayland support in KDE applications, it fulfills needs beyond what QtWayland provides. All the KDE applications in a plasma-wayland-session use this library and LXQt maybe as well. KWayland has been part of KDE Frameworks since 5.22 (May 2016); it was formerly distributed as part of KDE Plasma 5.|
|KWidgetsAddons||1||kwidgetsaddons.git Archived 2017-12-25 at the Wayback Machine||Addon with various classes on top of QtWidgets. If you are porting applications from KDE Platform 4 "kdeui" library, you will find many of its classes here. Provided are action classes that can be added to toolbars or menus, a wide range of widgets for selecting characters, fonts, colors, actions, dates and times, or MIME types, as well as platform-aware dialogs for configuration pages, message boxes, and password requests. Further widgets and classes can be found in other KDE frameworks.|
|KWindowSystem||1||kwindowsystem.git Archived 2019-02-02 at the Wayback Machine||Allows to interact with the windowing system. It provides a NETRootInfo for accessing the global state (all that's set on the root window) and NETWinInfo for all information about a specific window. The classes have a window manager and client perspective. This is the foundation which powers KWin and various parts of the graphical shell such as the taskmanager. On top of those X11-specific classes we have a convenient API KWindowInfo and KWindowSystem which provides a windowing system independent API for our applications.|
|KXMLGUI||3||kxmlgui.git Archived 2019-01-31 at the Wayback Machine||KXMLGUI provides a framework for managing menu and toolbar actions in an abstract way. The actions are configured through a XML description and hooks in the application code. The framework supports merging of multiple description for example for integrating actions from plugins.|
KXMLGui makes use of the Kiosk authorization functionality of KConfig (see the KAuthorized namespace in that framework). Notably, QAction instances added to a KActionCollection are disabled if KAuthorized::authorizeAction() reports that they are not authorized. The items on the standard help menu (KHelpMenu) can likewise be disabled based on Kiosk settings, and toolbar editing can be restricted. See KActionCollection, KHelpMenu and KToolBar documentation for more information.
|Plasma-framework||3||plasma-framework.git Archived 2017-12-28 at the Wayback Machine||Foundational libraries, runtime components and tools of the KDE Plasma workspaces based upon KF5 and Qt5. The plasma framework provides the following:
|Prison||1||prison.git Archived 2017-03-05 at the Wayback Machine||Prison is a Qt-based barcode abstraction layer/library and provides uniform access to generation of barcodes with data.|
|Solid||1||solid.git Archived 2017-12-28 at the Wayback Machine||Solid provides a way of querying and interacting with hardware independently of the underlying operating system. It provides the following features for application developers:|
|Sonnet||1||sonnet.git Archived 2017-12-28 at the Wayback Machine||Sonnet is a plugin-based spell checking library for Qt-based applications. It supports several different plugins, including HSpell, Enchant, ASpell and HUNSPELL. It also supports automated language detection, based on a combination of different algorithms. The simplest way to use Sonnet in your application is to use the SpellCheckDecorator class on your QTextEdit.|
|Syndication||2||syndication.git Archived 2019-01-30 at the Wayback Machine||Syndication is an RSS/Atom parser library.|
|ThreadWeaver||1||threadweaver.git Archived 2017-12-28 at the Wayback Machine||ThreadWeaver is a Job queue. It executes jobs in threads it internally manages.|
Kirigami is a QML application framework developed by Marco Martin that enables developers to write applications that run natively on Android, iOS, Windows, Plasma Mobile and any classic Linux desktop environment without code adjustments.
It is used by various applications, for example Linus Torvalds and Dirk Hohndels' scuba diving application Subsurface, the messenger client Banji, the Kaidan messenger, Vvave music player and the KDE software center Discover.
Linux distribution use some package management system to package the software they distribute. Debian for example distributes KGlobalAccel under the package name libkf5globalaccel, while Fedora Linux distributes it under the name kf5-kglobalaccel.
- Ruby (Korundum, built on top of QtRuby)
- C# (however, the current framework for binding to C# and other .NET languages has been deprecated, and the replacement only compiles on Windows).
These and other bindings use the following technologies:
- Smoke: for creating bindings for Ruby, C# and PHP
- SIP: for creating bindings for Python
Many bindings weren't updated to Qt5 and KF5 or only later in the release cycle.
The source code of KDE Frameworks has been around since KDElibs 1. The first release as KDE Frameworks was with version 5, to account for the fact that the code base was that of KDE Platform version 4 (the only major version of KDE Platform).
The major improvement of Frameworks 5 is its modularization. In earlier KDE versions, the libraries were bundled as a single large package. In Frameworks, the libraries were split into individual smaller packages. This facilitates utilization of the libraries by other Qt-based software, since dependencies can be kept at a minimum.
While KDE 4 was based on version 4 of the Qt widget toolkit, Frameworks 5 is based on version 5.
During KDE SC 4, the then so called KDE Platform consisted of all libraries and services needed for KDE Plasma and the applications. Starting with Qt 5, this platform was transformed into a set of modules that is now referred to as KDE Frameworks. These modules include: Solid, Nepomuk, Phonon, etc. and are licensed either under the LGPL, BSD license, MIT License or X11 license.
- "KDE Frameworks 5.94.0". 14 May 2022. Retrieved 15 May 2022.
- "Release of KDE Frameworks 5.24.0". 9 July 2016.
- "Android - KDE Community Wiki".
- "KDE API Homepage"".
- "First release of KDE Frameworks 5". 2014-07-07.
- "The KDE Frameworks". API Documentation.
- "KDE Frameworks". Tech Base.
- Howard Chan (2013-09-04). "KDE Release Structure Evolves". KDE. Retrieved 2014-02-27.
- "Release schedule for KDE Frameworks 5".
- "Git workflow for Frameworks".
- "KDE Frameworks5 API documentation". Archived from the original on 2014-08-22.
- "Coinstallability with KDE Platform 4".
- "metainfo.yaml of KConfig".[permanent dead link]
- Jos Poortvliet (2013-12-17). "Qt 5.2 - Foundation for KDE Frameworks 5". Dot.kde.org. Retrieved 2014-03-10.
- Howard Chan (2013-09-25). "Frameworks 5". Dot.kde.org. Retrieved 2014-03-10.
- "API Documentation". api.kde.org. Retrieved 2021-10-02.
- "KWindowSystem in Frameworks 5". 6 February 2014.
- "KDE Kirigami". KDE. Retrieved November 25, 2018.
- "Contributors to KDE/Kirigami". GitHub.
- Archived at Ghostarchive and the Wayback Machine: "Banji (Ring-KDE) new skin on desktop Linux and Android". YouTube.
- "Kaidan - A user-friendly XMPP client for every device!". GitHub. 4 July 2021.
- "KGlobalAccel in Debian".
- "KGlobalAccel in Fedora".[permanent dead link]
- "The KDE development platform". Retrieved 2010-11-26.
- Development/Languages - KDE TechBase. Techbase.kde.org (2012-07-12). Retrieved on 2013-07-17.
- "Qyoto". Retrieved 2015-01-18.
- "Frameworks 5 Technology Preview". KDE. 2014-01-07.
- "KDE Ships First Alpha of Frameworks 5". KDE. 2014-02-14.
- "KDE Ships Second Alpha of Frameworks 5". KDE. 2014-03-03.
- "KF5 Update Meeting Minutes 2014-w28". 2014-07-08.
- "Firefox + KDE integration: Getting FF to use Dolphin reliably". 2014-07-03.
- "KDE Licensing Policy". Retrieved 2010-11-06.