Skip to content

styling ​

Theme, palette, and rounding tokens applied shell-wide. Changes recompile the stylesheet.

General ​

FieldTypeDefaultDescription
scaleScaleFactor1Scale multiplier for dropdowns, popovers, and dialogs.
roundingRoundingLevel"default"Corner rounding for dropdowns, popovers, and dialogs.
appearanceAppearance"auto"Light/dark appearance mode. Auto follows each provider / the configured palette; Light/Dark force the mode (static palettes swap to their built-in light/dark variant when one exists).
high-contrastboolfalseAsk apps for higher contrast: the contrast preference the desktop portal tells GTK, Qt and Chromium apps.
theming-monitorstring""Monitor whose wallpaper drives color extraction. Empty uses the first available.
palette_base_themestring""Currently active theme preset name, and/or the base for the palette when the palette has been modified. Persisted backing state for the theme selector; not a labeled setting of its own.

Theme provider ​

FieldTypeDefaultDescription
theme-providerThemeProvider"lys-shell"Theme provider (lys-shell, matugen, pywal, wallust).

Matugen ​

FieldTypeDefaultDescription
matugen-schemeMatugenScheme"tonal-spot"Matugen color scheme type.
matugen-contrastSignedNormalizedF640Matugen contrast level (-1.0 to 1.0).
matugen-source-coloru80Matugen source color index (0-3).
matugen-lightboolfalseMatugen light mode.

Wallust ​

FieldTypeDefaultDescription
wallust-paletteWallustPalette"dark16"Wallust palette mode.
wallust-saturationPercentage0Wallust saturation boost (0-100, 0 disables).
wallust-check-contrastbooltrueWallust contrast checking against background.
wallust-backendWallustBackend"fastresize"Wallust image sampling backend.
wallust-colorspaceWallustColorspace"labmixed"Wallust color space for dominant color selection.
wallust-apply-globallybooltrueApply wallust colors to terminals and external tools.

Pywal ​

FieldTypeDefaultDescription
pywal-saturationNormalizedF640.05Pywal saturation adjustment (0.0-1.0).
pywal-contrastPywalContrast3Pywal minimum contrast ratio (1.0-21.0).
pywal-lightboolfalsePywal light mode.
pywal-apply-globallybooltrueApply pywal colors to terminals and external tools.

Palette ​

FieldTypeDefaultDescription
palettePaletteConfig{...}Active color palette.

Default configuration ​

yaml
styling:
  scale: 1.0
  rounding: default
  appearance: auto
  high-contrast: false
  theme-provider: lys-shell
  theming-monitor: ""
  matugen-scheme: tonal-spot
  matugen-contrast: 0.0
  matugen-source-color: 0
  matugen-light: false
  wallust-palette: dark16
  wallust-saturation: 0
  wallust-check-contrast: true
  wallust-backend: fastresize
  wallust-colorspace: labmixed
  wallust-apply-globally: true
  pywal-saturation: 0.05
  pywal-contrast: 3.0
  pywal-light: false
  pywal-apply-globally: true
  palette:
    bg: '#141420'
    surface: '#1c1c2c'
    elevated: '#262638'
    fg: '#d4d6e8'
    fg-muted: '#8a8ca4'
    primary: '#e0947a'
    red: '#e46870'
    yellow: '#e0b870'
    green: '#68c898'
    blue: '#78a0e0'
  palette_base_theme: ""

Released under the MIT License.