How kde/dolphin works
Purpose and Runtime
Dolphin is KDE’s native desktop file manager: a C++/Qt GUI for browsing local and remote locations, manipulating files, and presenting metadata-rich directory views. It is built with CMake and integrates with KDE Frameworks, especially KIO-backed file/location access, KDE plugin infrastructure, configuration, and desktop services. Core build composition is in CMakeLists.txt, src/CMakeLists.txt.
Application Entry and Shell
src/main.cpp starts the standalone application and creates the primary window. src/dolphinmainwindow.cpp owns global menus, actions, toolbars, docking/panels, tabs, and view containers; src/dolphinpart.cpp exposes Dolphin as an embeddable KDE Part. Desktop launch and component metadata are src/org.kde.dolphin.desktop and src/dolphinpart.json.in.
Navigation, Tabs, and View Lifecycle
A main window hosts tab pages and one or more view containers, supporting tabbed and split navigation. src/dolphintabwidget.cpp, src/dolphintabpage.cpp, and src/dolphinviewcontainer.cpp coordinate active locations and view focus. URL entry/navigation is handled by src/dolphinurlnavigator.cpp and src/dolphinurlnavigatorscontroller.cpp; location changes ultimately drive a DolphinView.
File Browsing Data-to-UI Pipeline
src/views/dolphinview.cpp is the central directory-view controller: it coordinates loading a URL, selection, actions, drag/drop, and view properties. src/kitemviews/kfileitemmodel.cpp models file items and roles, while src/kitemviews/kitemlistcontroller.cpp manages interaction/selection and src/views/dolphinitemlistview.cpp adapts the generic item-view layer to Dolphin behavior. This boundary separates asynchronous file enumeration/metadata from Qt widget presentation and input handling. Baloo-related roles and directory counting live behind private view-model support in src/kitemviews/private/kbaloorolesprovider.cpp and src/kitemviews/private/kdirectorycontentscounter.cpp.
File Operations and Extensibility
User actions route from window/view actions and context menus into KDE file-operation services rather than a repository-local filesystem backend. src/dolphincontextmenu.cpp assembles context actions; src/views/draganddrophelper.cpp handles transfer semantics; src/dolphinnewfilemenu.cpp creates files/folders. Item-action plugins are independently built/discovered components under src/itemactions/CMakeLists.txt, with metadata such as src/itemactions/hidefileitemaction.json. Version-control state is asynchronous and plugin-facing through src/views/versioncontrol/kversioncontrolplugin.cpp and src/views/versioncontrol/updateitemstatesthread.cpp.
Search, Panels, and Auxiliary Surfaces
Search UI turns user-entered terms and filter chips into a structured query in src/search/dolphinquery.cpp, with controls in src/search/bar.cpp; execution is expected to pass through the location/KIO layer rather than an in-tree search engine. Dock panels provide places, folder trees, metadata previews, and an embedded terminal: src/panels/places/placespanel.cpp, src/panels/information/informationpanel.cpp, src/panels/terminal/terminalpanel.cpp. The terminal panel includes a KIOFuse D-Bus interface declaration at src/panels/terminal/org.kde.KIOFuse.VFS.xml.
Persistence, IPC, and Desktop Integration
Settings use KDE configuration schemas and are applied to views and UI by src/settings/dolphinsettingsdialog.cpp, src/settings/applyviewpropsjob.cpp, and src/views/viewproperties.cpp; migration scripts/updates preserve older settings. D-Bus exposure is defined by src/dbusinterface.cpp, and plasma-dolphin.service.in supports desktop-service activation. Trash behavior is encapsulated in src/trash/dolphintrash.cpp; optional telemetry/user feedback is supplied through src/userfeedback/dolphinfeedbackprovider.cpp.
Main entry points: dolphinmainwindow.cpp Dolphin main window · dolphinview.cpp DolphinView · dolphincontextmenu.cpp Context and new-file actions · kfileitemmodel.cpp File item model
Components 19
Application Shell
- Application entry
src/main.cpp - Dolphin main window · Owns global actions, tabs, panels, and view containers.
src/dolphinmainwindow.cpp - Embeddable Dolphin Part
src/dolphinpart.cpp
Navigation & Views
- Tabs and view containers · Coordinates active locations, split views, and focus.
src/dolphintabwidget.cpp - URL navigator
src/dolphinurlnavigator.cpp
Directory View Pipeline
- DolphinView · Coordinates URL loading, actions, selection, and drag/drop.
src/views/dolphinview.cpp - File item model · Provides file items, metadata, and roles.
src/kitemviews/kfileitemmodel.cpp - Item interaction controller
src/kitemviews/kitemlistcontroller.cpp - Dolphin item list view
src/views/dolphinitemlistview.cpp
KDE Integration
- KIO location services · Provides local and remote access, enumeration, search, and file operations.
- Settings and view properties · Applies KDE settings to views and UI.
src/settings/dolphinsettingsdialog.cpp - D-Bus desktop service
src/dbusinterface.cpp - Trash integration
src/trash/dolphintrash.cpp
Extensions & Surfaces
- Context and new-file actions
src/dolphincontextmenu.cpp - Item-action plugins · Independently built and discovered context actions.
src/itemactions/CMakeLists.txt - Version-control state
src/views/versioncontrol/kversioncontrolplugin.cpp - Search query and bar
src/search/dolphinquery.cpp - Dock panels · Places, information, and terminal surfaces.
src/panels/places/placespanel.cpp
Other components
- CMake build composition
CMakeLists.txt
Connections 21
- CMake build composition → Application entry: builds
- Application entry → Dolphin main window: creates
- Dolphin main window → Embeddable Dolphin Part: also exposed as
- Dolphin main window → Tabs and view containers: hosts
- Dolphin main window → URL navigator: hosts
- Tabs and view containers → DolphinView: manages
- URL navigator → DolphinView: navigates
- DolphinView → File item model: loads items from
- File item model → KIO location services: enumerates via
- DolphinView → Item interaction controller: coordinates
- Item interaction controller → Dolphin item list view: drives input on
- Dolphin item list view → File item model: presents
- Dolphin main window → Context and new-file actions: routes actions to
- Context and new-file actions → Item-action plugins: loads
- Context and new-file actions → KIO location services: executes operations through
- DolphinView → Version-control state: requests state from
- Search query and bar → KIO location services: executes through
- Dolphin main window → Dock panels: docks
- Settings and view properties → DolphinView: applies properties to
- Dolphin main window → D-Bus desktop service: exposes
- Context and new-file actions → Trash integration: uses