Skip to content

Config Options

koss edited this page Oct 11, 2026 · 2 revisions

theme

Option Type Default Description
colorScheme path "" Path to a KDE color scheme (.colors) file, e.g. /usr/share/color-schemes/BreezeDark.colors. ~ is expanded. Leave empty to use the style's own palette.
iconTheme string "" Name of an installed icon theme, e.g. breeze-dark or Papirus.
style string "" Widget style to use, e.g. Breeze or Fusion. Empty or an unknown name falls back to Fusion.
quickStyle string "" QtQuick Controls style for QML apps, e.g. org.kde.desktop. Empty leaves it up to the app.
font object see below The regular UI font.
fontFixed object see below The monospace font.

Font

font and fontFixed take the same keys:

Option Type Default Description
family string "Sans Serif" / "monospace" Font family name.
size int 11 Size in points.
weight int -1 Font weight. -1 means normal.

misc

Option Type Default Description
singleClickActivate bool true Open items in file dialogs and list views with a single click instead of a double click.
menusHaveIcons bool true Show icons next to menu entries.
shortcutsForContextMenus bool true Show keyboard shortcuts in right-click menus.
cursorFlashTime int 1000 Time in ms for one full text cursor blink (on + off). 0 stops the blinking.
mouseDoubleClickInterval int 400 Maximum time in ms between two clicks for them to count as a double click.
wheelScrollLines int 3 Lines scrolled per mouse wheel notch.
toolButtonStyle int 4 How toolbar buttons show their icon and label. See values.
dialogButtonBoxLayout int 0 Order of the OK/Cancel/etc. buttons in dialogs. See values.
keyboardScheme int 2 Which platform's standard shortcuts to follow. See values.
uiEffects int 0 Bitmask of UI animations to turn on. See values.
dialogTheme string "" Passthrough dialog theme to a different theme.

toolButtonStyle

Value Meaning
0 Icon only
1 Text only
2 Text beside the icon
3 Text under the icon
4 Let the widget style decide

dialogButtonBoxLayout

Value Meaning
0 Windows
1 macOS
2 KDE
3 GNOME

keyboardScheme

This mostly affects standard shortcuts that differ between platforms. For example, Redo is Ctrl+Y on the Windows scheme and Ctrl+Shift+Z on the KDE scheme.

Value Meaning
0 Windows
1 macOS
2 X11
3 KDE
4 GNOME
5 CDE

uiEffects

Add up the effects you want. 1 has to be included for any of the others to do anything, so 19 (1 + 2 + 16) enables animated menus and tooltips.

Value Effect
1 Enable UI effects at all
2 Animate menus
4 Fade menus
8 Animate combo boxes
16 Animate tooltips
32 Fade tooltips
64 Animate tool boxes
128 Hover effects

Full example

{
  "theme": {
    "colorScheme": "~/.local/share/color-schemes/MyScheme.colors",
    "iconTheme": "breeze-dark",
    "style": "Breeze",
    "quickStyle": "org.kde.desktop",
    "font": { "family": "Inter", "size": 11, "weight": -1 },
    "fontFixed": { "family": "JetBrains Mono", "size": 10, "weight": -1 }
  },
  "misc": {
    "singleClickActivate": false,
    "menusHaveIcons": true,
    "shortcutsForContextMenus": true,
    "cursorFlashTime": 1000,
    "mouseDoubleClickInterval": 400,
    "wheelScrollLines": 3,
    "toolButtonStyle": 4,
    "dialogButtonBoxLayout": 2,
    "keyboardScheme": 3,
    "uiEffects": 0
  }
}

Clone this wiki locally