# Configuration keys

Here you find a list of commonly used configuration keys to use with the `writeConfig()` command. Where the documentation notes that a key is in a subgroup other than `General`, remember to first use `currentConfigGroup`.

### org.kde.plasma.keyboardlayout

#### General

* displayStyle: (`Enum`, default: `0`) Whether to show text, a flag, or both on the compact representation.

### org.kde.plasma.kicker

#### General

* icon: (`String`, default: `start-here-kde-symbolic`) The name of the icon to use for the compact representation (e.g. on a small panel).
* useCustomButtonImage: (`Bool`, default: `false`) Whether to use a custom image instead of an icon in the compact representation (e.g. on a small panel).
* customButtonImage: (`Url`, default: `null`) The URL of the custom image to use instead of an icon in the compact representation (e.g. on a small panel).
* appNameFormat: (`Int`, default: `0`) The format used in the display of application names: 0 = NameOnly, 1 = GenericNameOnly, 2 = NameAndGenericName, 3 = GenericNameAndName
* limitDepth: (`Bool`, default: `false`) Whether to flatten top-level menu categories to a single level instead of displaying sub-categories.
* alphaSort: (`Bool`, default: `false`) Whether to sort menu contents alphabetically or use manual/system sort order.
* recentOrdering: (`Int`, default: `0`) How should the previously used apps/docs be ordered: 0 = RecentFirst, 1 = PopularFirst
* favoriteApps: (`StringList`, default: `preferred://browser,org.kde.kontact.desktop,systemsettings.desktop,org.kde.dolphin.desktop,org.kde.discover`) List of general favorites. Supported values are menu id's (usually .desktop file names), special URLs that expand into default applications (e.g. preferred://browser), document URLs and KPeople contact URIs.
* favoriteSystemActions: (`StringList`, default: `logout,reboot,shutdown`) List of system action favorites.
* favoritesPortedToKAstats: (`Bool`, default: `false`) Are the favorites ported to use KActivitiesStats to allow per-activity favorites
* hiddenApplications: (`StringList`, default: `empty list`) List of menu id's (usually .desktop file names) of apps that should not be shown in the menu.
* showRecentApps: (`Bool`, default: `true`) Whether to show the "Recent Applications" category.
* showRecentDocs: (`Bool`, default: `true`) Whether to show the "Recent Files" category.
* useExtraRunners: (`Bool`, default: `true`) Whether to use additional KRunner plugins to produce results in the search.
* extraRunners: (`StringList`, default: `krunner_shell,krunner_bookmarksrunner,baloosearch,locations`) The plugin id's of additional KRunner plugins to use. Only used if useExtraRunners is true.
* alignResultsToBottom: (`Bool`, default: `true`) Whether to align search results to the bottom of the menu representation (e.g. panel popup) instead of the top.
* showIconsRootLevel: (`Bool`, default: `false`) Whether to show icons on the root level of the menu.

### org.kde.plasma.kickoff

#### General

* icon: (`String`, default: `start-here-kde-symbolic`) The name of the icon used in the compact representation (e.g. on a small panel).
* menuLabel: (`string`, default: `null`) Text label for the Panel button
* favorites: (`StringList`, default: `preferred://browser,org.kde.kontact.desktop,systemsettings.desktop,org.kde.dolphin.desktop,org.kde.discover.desktop`) List of general favorites. Supported values are menu id's (usually .desktop file names), special URLs that expand into default applications (e.g. preferred://browser), document URLs and KPeople contact URIs.
* systemFavorites: (`StringList`, default: `suspend,hibernate,reboot,shutdown`) List of system action favorites.
* primaryActions: (`Int`, default: `0`) Which actions should be displayed in the footer: 0 = Power, 1 = Session, 2 = Custom, 3 = Power and session
* favoritesPortedToKAstats: (`Bool`, default: `false`) Are the favorites ported to use KActivitiesStats to allow per-activity favorites
* systemApplications: (`StringList`, default: `systemsettings.desktop,org.kde.kinfocenter.desktop,org.kde.discover.desktop`) List of applications at the top of the "Computer" tab.
* paneSwap: (`Bool`, default: `false`) Whether to swap the sidebar and content panes
* favoritesDisplay: (`Int`, default: `0`) How to display favorites: 0 = Grid, 1 = List
* applicationsDisplay: (`Int`, default: `1`) How to display applications: 0 = Grid, 1 = List
* alphaSort: (`Bool`, default: `false`) Whether to sort menu contents alphabetically or use manual/system sort order.
* pin: (`Bool`, default: `false`) Whether the popup should remain open when another window is activated
* showActionButtonCaptions: (`Bool`, default: `true`) Whether to display captions ("shut down", "log out", etc.) for the footer action buttons
* compactMode: (`Bool`, default: `false`) Whether to use a compact display style for list items

### org.kde.plasma.kimpanel

#### Appearance

* vertical\_lookup\_table: (`Bool`, default: `false`)
* use\_default\_font: (`Bool`, default: `true`)
* font: (`Font`, default: `null`)
* hiddenList: (`StringList`, default: `empty list`)
* scaleIconsToFit: (`bool`, default: `false`) Whether to automatically scale System Tray icons to fix the available thickness of the panel. If false, tray icons will be capped at the smallMedium size (22px) and become a two-row/column layout when the panel is thick.

### org.kde.plasma.marginsseparator

#### General

* icon: (`String`, default: `user-desktop`)

### org.kde.plasma.pager

#### General

* displayedText: (`Enum`, default: `2`) The text to show inside the desktop rectangles.
* showWindowOutlines: (`Bool`, default: `true`) Whether to show window outlines.
* showWindowIcons: (`Bool`, default: `false`) Whether to show window icons inside the window rectangles.
* showOnlyCurrentScreen: (`Bool`, default: `false`) Whether to limit the Pager to the set of windows and the geometry of the screen the widget resides on.
* wrapPage: (`Bool`, default: `false`) Whether to wrap page when navigating with pager
* currentDesktopSelected: (`Enum`, default: `0`) What to do on left-mouse click on a desktop rectangle.
* pagerLayout: (`Enum`, default: `0`) The layout style used for the presentation.

### org.kde.plasma.showActivityManager

#### General

* showActivityName: (`Bool`, default: `true`) Show the current activity name
* showActivityIcon: (`Bool`, default: `true`) Show the current activity icon instead of the applet icon

### org.kde.plasma.showdesktop

#### General

* icon: (`String`, default: `user-desktop-symbolic`)

### org.kde.plasma.taskmanager

#### General

* showOnlyCurrentScreen: (`Bool`, default: `false`) Whether to show only window tasks that are on the same screen as the widget.
* showOnlyCurrentDesktop: (`Bool`, default: `true`) Whether to only show tasks that are on the current virtual desktop.
* showOnlyCurrentActivity: (`Bool`, default: `true`) Whether to show only tasks that are on the current activity.
* showOnlyMinimized: (`Bool`, default: `false`) Whether to show only window tasks that are minmized.
* unhideOnAttention: (`Bool`, default: `true`) Whether to unhide if a window wants attention.
* groupingStrategy: (`Enum`, default: `1`) How tasks are grouped: 0 = Do Not Group, 1 = By Program Name
* groupedTaskVisualization: (`Enum`, default: `0`) What happens when clicking on a grouped task: 0 = cycle through grouped tasks, 1 = try to show tooltips, 2 = try to show present Windows effect, 3 = show textual list (AKA group dialog)
* groupPopups: (`Bool`, default: `true`) Whether groups are to be reduced to a single task button and expand into a popup or task buttons are grouped on the widget itself.
* onlyGroupWhenFull: (`Bool`, default: `true`) Whether to group always or only when the widget runs out of space to show additional task buttons comfortably.
* groupingAppIdBlacklist: (`StringList`, default: `empty list`) The id's (usually .desktop file names) of applications that should not have their tasks grouped.
* groupingLauncherUrlBlacklist: (`StringList`, default: `empty list`) The launcher URLs (usually .desktop file or executable URLs) of applications that should not have their tasks grouped.
* sortingStrategy: (`Int`, default: `1`) How to sort tasks: 0 = Do Not Sort, 1 = Manually, 2 = Alphabetically, 3 = By Desktop, 4 = By Activity
* separateLaunchers: (`Bool`, default: `true`) Whether launcher tasks are sorted separately at the left side of the widget or can be mixed with other tasks.
* hideLauncherOnStart: (`Bool`, default: `true`) Whether launcher tasks should be hidden when their application is launched.
* maxStripes: (`Int`, default: `1`) The maximum number of rows (in a horizontal-orientation containment, i.e. panel) or columns (in a vertical-orientation containment) to layout task buttons in.
* forceStripes: (`Bool`, default: `false`) Whether to try and always layout task buttons in as many rows/columns as set via maxStripes.
* showToolTips: (`Bool`, default: `true`) Whether to show tooltips when hovering task buttons.
* taskMaxWidth: (`Enum`, default: `1`) Tune the max width of task items.
* wheelEnabled: (`Bool`, default: `true`) Whether using the mouse wheel with the mouse pointer above the widget should switch between tasks.
* wheelSkipMinimized: (`Bool`, default: `true`) Whether to skip minimized tasks when switching between them using the mouse wheel.
* highlightWindows: (`Bool`, default: `true`) Whether to request the window manager highlight windows when hovering corresponding task tooltips.
* launchers: (`StringList`, default: `applications:systemsettings.desktop,applications:org.kde.discover.desktop,preferred://filemanager,preferred://browser`) The list of launcher tasks on the widget. Usually .desktop file or executable URLs. Special URLs such as preferred://browser that expand to default applications are supported.
* middleClickAction: (`Enum`, default: `2`) What to do on middle-mouse click on a task button.
* indicateAudioStreams: (`Bool`, default: `true`) Whether to indicate applications that are playing audio including an option to mute them.
* fill: (`Bool`, default: `true`) Whether task manager should occupy all available space.
* taskHoverEffect: (`Bool`, default: `true`) Whether task buttons should change in appearance when the mouse pointer is above them.
* maxTextLines: (`Int`, default: `0`) The maximum number of text lines to show in a task button. 0 means no limit.
* minimizeActiveTaskOnClick: (`Bool`, default: `true`) Whether to minimize the currently-active task when clicked. If false, clicking on the currently-active task will do nothing.
* reverseMode: (`Bool`, default: `false`) Whether to grow the tasks in according to system configuration or opposite to system configuration.
* iconSpacing: (`Int`, default: `1`) Spacing between icons in task manager. Margin is multiplied by this value.

### org.kde.plasma.windowlist

#### General

* showText: (`Bool`, default: `true`) Whether to show the window title when the applet is used on a horizontal panel

### org.kde.plasma.binaryclock

#### General

* showOffLeds: (`Bool`, default: `true`)
* showSeconds: (`Bool`, default: `true`)
* useCustomColorForActive: (`Bool`, default: `false`)
* customColorForActive: (`Color`, default: `green`)
* useCustomColorForInactive: (`Bool`, default: `false`)
* customColorForInactive: (`Color`, default: `red`)
* useCustomColorForGrid: (`Bool`, default: `false`)
* customColorForGrid: (`Color`, default: `blue`)

### org.kde.plasma.colorpicker

#### General

* history: (`StringList`, default: `empty list`)
* autoClipboard: (`Bool`, default: `true`)
* defaultFormat: (`String`, default: `#RRGGBB`)
* pickOnActivate: (`Bool`, default: `true`)
* compactPreviewCount: (`Int`, default: `1`)

### org.kde.plasma\_applet\_dict

#### General

* dictionary: (`String`, default: `all`)

### org.kde.plasma.fifteenpuzzle

#### Appearance

* imagePath: (`String`, default: `empty string`)
* useImage: (`Bool`, default: `false`)
* showNumerals: (`Bool`, default: `true`)
* boardColor: (`Color`, default: `#333333`)
* numberColor: (`Color`, default: `#ffffff`)
* boardSize: (`Int`, default: `4`)

### org.kde.plasma.fuzzyclock

#### Appearance

* fuzzyness: (`Int`, default: `1`)
* boldText: (`Bool`, default: `false`)
* italicText: (`Bool`, default: `false`)

### org.kde.plasma.keyboardindicator

#### General

* key: (`StringList`, default: `Caps Lock`)

### org.kde.plasma.mediaframe

#### General

* interval: (`Double`, default: `10.0`)
* randomize: (`Bool`, default: `true`)
* pauseOnMouseOver: (`Bool`, default: `true`)
* leftClickOpenImage: (`Bool`, default: `true`)
* showCountdown: (`Bool`, default: `true`)
* fillMode: (`int`, default: `1`)

#### Paths

* pathList: (`StringList`, default: `empty list`)

### org.kde.plasma.notes

#### General

* color: (`String`, default: `yellow`)
* fontSize: (`int`, default: `null`)
* noteId: (`String`, default: `empty string`)
* scrollX: (`Double`, default: `0`)
* scrollY: (`Double`, default: `0`)
* cursorPosition: (`Int`, default: `0`)

### org.kde.plasma.quicklaunch

#### General

* maxSectionCount: (`Int`, default: `1`)
* showLauncherNames: (`Bool`, default: `false`)
* enablePopup: (`Bool`, default: `false`)
* title: (`String`, default: `empty string`)
* launcherUrls: (`StringList`, default: `empty list`)
* popupUrls: (`StringList`, default: `empty list`)

### org.kde.plasma.timer

#### General

* predefinedTimers: (`StringList`, default: `30,60,120,300,450,600,900,1200,1500,1800,2700,3600`)
* running: (`int`, default: `0`)
* seconds: (`int`, default: `0`)
* savedAt: (`DateTime`, default: `null`)
* showTitle: (`Bool`, default: `false`)
* title: (`String`, default: `Timer`)
* showRemainingTime: (`Bool`, default: `true`)
* showSeconds: (`Bool`, default: `true`)
* showTimerToggle: (`Bool`, default: `true`)
* showProgressBar: (`Bool`, default: `false`)
* showNotification: (`Bool`, default: `true`)
* notificationText: (`String`, default: `Timer finished`)
* runCommand: (`Bool`, default: `false`)
* command: (`String`, default: `empty string`)

### org.kde.plasma.userswitcher

#### General

* showFace: (`Bool`, default: `false`)
* showName: (`Bool`, default: `true`)
* showFullName: (`Bool`, default: `true`)
* showTechnicalInfo: (`Bool`, default: `false`)

### org.kde.plasma.weather

#### WeatherStation

* updateInterval: (`int`, default: `30`)
* source: (`string`, default: `null`)

#### Appearance

* showTemperatureInCompactMode: (`bool`, default: `false`)
* showTemperatureInBadge: (`bool`, default: `false`)
* showTemperatureInTooltip: (`bool`, default: `true`)
* showWindInTooltip: (`bool`, default: `true`)
* showPressureInTooltip: (`bool`, default: `false`)
* showHumidityInTooltip: (`bool`, default: `true`)

#### Units

* temperatureUnit: (`int`, default: `null`)
* pressureUnit: (`int`, default: `null`)
* speedUnit: (`int`, default: `null`)
* visibilityUnit: (`int`, default: `null`)

### org.kde.plasma.webbrowser

#### General

* useDefaultUrl: (`Bool`, default: `false`)
* defaultUrl: (`String`, default: `https://www.kde.org/`)
* url: (`String`, default: `https://www.kde.org/`)
* useMinViewWidth: (`Bool`, default: `true`)
* minViewWidth: (`Int`, default: `600`)
* constantZoomFactor: (`Int`, default: `100`)
* icon: (`String`, default: `empty string`) The name of the icon used in the compact representation (e.g. on a small panel).
* favIcon: (`String`, default: `empty string`) The url of the website's favicon that is saved in the last session.
* useFavIcon: (`Bool`, default: `true`) Use the website's favicon instead of a system icon
* enableNavigationBar: (`Bool`, default: `true`)

### org.kde.plasma.analogclock

#### General

* showSecondHand: (`Bool`, default: `false`)
* showTimezoneString: (`Bool`, default: `false`)

### org.kde.plasma.appmenu

#### Appearance

* compactView: (`Bool`, default: `false`) If true it only shows a button for the application menu.

### org.kde.plasma.calendar

#### Agenda

* startOfWorkingDay: (`int`, default: `9`)
* endOfWorkingDay: (`int`, default: `17`)
* showWeekNumbers: (`Bool`, default: `false`)
* compactDisplay: (`String`, default: `d`)

### org.kde.plasma.clipboard

#### General

* barcodeType: (`String`, default: `QRCode`)

### org.kde.plasma.devicenotifier

#### General

* removableDevices: (`Bool`, default: `true`) If true it lists removable devices, such as USB thumbdrives. Only one between removableDevices, nonRemovableDevices and allDevices should be set.
* nonRemovableDevices: (`Bool`, default: `false`) If true it lists non removable devices, such as internal harddrives. Only one between removableDevices, nonRemovableDevices and allDevices should be set.
* allDevices: (`Bool`, default: `false`) If true it lists all kind of devices. Only one between removableDevices, nonRemovableDevices and allDevices should be set.
* popupOnNewDevice: (`Bool`, default: `true`) If true it tries to open the plasmoid when a new device is inserted, as a kind of notification.

### org.kde.plasma.digitalclock

#### Appearance

* showLocalTimezone: (`Bool`, default: `false`) Whether the time zone should be displayed when the clock is showing the local time zone.
* showSeconds: (`Enum`, default: `1`) How seconds should be shown in the clock.
* showDate: (`Bool`, default: `true`) Whether the date should be shown next to the clock.
* dateFormat: (`string`, default: `shortDate`) The date format to display. Options are: shortDate, longDate, isoDate or custom.
* customDateFormat: (`string`, default: `ddd d`) Custom date format string.
* autoFontAndSize: (`Bool`, default: `true`) Use Plasma default font and automatically determine font size.
* fontFamily: (`string`, default: `null`) Font family. e.g "arial". The system font is used if this is not set.
* boldText: (`Bool`, default: `false`) Sets the font to bold.
* italicText: (`Bool`, default: `false`) Sets the font to italic.
* fontWeight: (`Int`, default: `50`) Sets font weight.
* fontStyleName: (`string`, default: `null`) Sets font style
* fontSize: (`Int`, default: `10`) Sets font size.
* timeFormat: (`string`, default: `default`)
* selectedTimeZones: (`StringList`, default: `Local`) A list of the configured time zones. Format is "Europe/London". Special entry "Local" indicates system time zone.
* lastSelectedTimezone: (`String`, default: `Local`) When multiple time zones are configured, this is the one shown on widget restore. Typically the system's current time zone.
* wheelChangesTimezone: (`Bool`, default: `false`) Whether the mouse wheel switches between the time zones configured in selectedTimeZones.
* displayTimezoneFormat: (`Enum`, default: `0`) Whether the time zone is displayed as a code i.e. "GMT", full text i.e. "London" or UTC offset "+1".
* showWeekNumbers: (`Bool`, default: `false`) Whether the calendar should show week numbers.
* use24hFormat: (`UInt`, default: `1`) Force the clock to use 12/24 hour time, instead of following the user locale.
* firstDayOfWeek: (`Int`, default: `-1`) Force the calendar to use a specific week day as first day of a week. -1 means follow user locale, 0 is Sunday, 1 is Monday, etc.
* enabledCalendarPlugins: (`StringList`, default: `empty list`) A list of plugins where additional calendar event data can be sourced.
* pin: (`Bool`, default: `false`) Whether the popup should remain open when another window is activated
* dateDisplayFormat: (`Enum`, default: `0`) Whether the date should be shown below or beside the time

### org.kde.plasma.icon

#### General

* url: (`String`, default: `empty string`)
* localPath: (`String`, default: `empty string`)

### org.kde.plasma.lock\_logout

#### General

* show\_requestShutDown: (`Bool`, default: `false`) Show an option to shut down the system.
* show\_requestReboot: (`Bool`, default: `false`) Show an option to reboot the system.
* show\_requestLogout: (`Bool`, default: `false`) Show an option to logout.
* show\_requestLogoutScreen: (`Bool`, default: `true`) Show an option to display the logout screen.
* show\_lockScreen: (`Bool`, default: `true`) Show an option to lock the system.
* show\_switchUser: (`Bool`, default: `false`) Show an option to switch user.
* show\_suspendToDisk: (`Bool`, default: `false`) Show an option to suspend the system to disk (hibernate).
* show\_suspendToRam: (`Bool`, default: `false`) Show an option to suspend the system suspend.

### org.kde.plasma.panelspacer

#### General

* expanding: (`bool`, default: `true`) If true, the spacer tries to take all the available space in the panel.
* length: (`Int`, default: `-1`) length in pixels of the spacer. Configuration effective only if expanding is set to false. A negative value means an invalid value that should be completely ignored.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.novaflowos.com/start/kde-developer-platform/readme/plasma/scripting/keys.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.