Skip to main content
The Klassy Settings GUI application is the primary tool for configuring all aspects of the Klassy theme, including window decorations, button styles, animations, and system icons.

​
Launching Klassy Settings

1

Open from terminal

Run the klassy-settings command:
klassy-settings
2

Access from System Settings

Alternatively, access Klassy Settings through KDE System Settings under Appearance > Window Decorations.

​
Main Interface

Klassy Settings provides a tabbed interface with two main configuration modules:
  • Application Style - Configure widget styles, scrollbars, and application-level theming
  • Window Decorations - Configure titlebar appearance, buttons, spacing, and window borders

​
Window Decoration Configuration

The Window Decoration module is organized into several tabs:

​
General Tab

Configure the core appearance of window decorations:
​
Button Icon Style
select
Choose from built-in perfectly-pixel-snapped button icons or window-*-symbolic system icons
​
Button Shape
select
Options include:
  • Integrated Rounded Rectangles (default)
  • Full-height Rounded Rectangle
  • Full-height Rectangle
  • Circular
​
Corner Radius
number
Set the corner radius for windows (pixels, scaled for HiDPI)
​
Match Titlebar to Application Color
boolean
When enabled, the titlebar inherits colors from the application’s header area
​
Draw Background Gradient
boolean
Adds a subtle gradient effect to the titlebar background

​
Advanced Configuration Dialogs

Click the configuration buttons to access detailed settings: System Icon Generation…
  • Configure which icon theme the Klassy and Klassy Dark themes inherit from
  • See System Icon Generation for details
Button Sizing…
  • Configure button size, spacing, and clickable area
  • Adjust button aspect ratio and padding
Button Colors…
  • Customize colors for each button type (Close, Minimize, Maximize, etc.)
  • Configure hover and pressed states
  • Set up “traffic lights” color scheme or custom palettes
Button Behaviour…
  • Control button hover animations
  • Configure background colors and opacity
  • Set outline styles and thickness
TitleBar Spacing…
  • Adjust titlebar margins (sides, top/bottom)
  • Configure different spacing for maximized windows
  • Set button spacing (left and right)
TitleBar Opacity…
  • Configure transparency for active/inactive windows
  • Set opacity for maximized windows separately
  • Enable/disable blur effects
Window Outline Style…
  • Configure thin window outlines
  • Set accent colors and blending modes
  • Adjust outline thickness
Shadow Style…
  • Configure window shadow appearance
  • Adjust shadow size, offset, and opacity

​
Animations Tab

​
Enable Animations
boolean
Toggle button and titlebar animations on/off
​
Animation Speed
slider
Adjust animation speed relative to system settings (percentage)

​
Exceptions Tab

Create window-specific overrides for decoration settings based on:
  • Window class
  • Window title (supports regex)
  • Window role
Exceptions allow you to apply different decoration styles to specific applications.

​
Presets

​
Using Presets

Klassy includes numerous built-in presets that apply coordinated style configurations:
1

Open Presets dialog

Click the Presets… button in the top-right corner of the Window Decorations tab
2

Select a preset

Browse the list of available presets:
  • Kite - Default pragmatic theme
  • ClassiK v3 - Full-height rounded rectangles
  • ClassikStyles - Rectangle highlights
  • Classik-Aurorae - Circular button highlights
  • Glassy Klassy - Translucent glass effect
  • Chroma - Colorful accent-based theme
  • And many more…
3

Load the preset

Click Load to apply the selected preset immediately
After loading a preset, you can further customize any settings. The preset serves as a starting point.

​
Managing Presets

The Presets dialog provides several management options: Add…
  • Save your current configuration as a new preset
  • Name it for easy identification later
Remove
  • Delete custom presets you’ve created
  • Built-in bundled presets cannot be removed
Export To File…
  • Export a preset to a .klpw (Klassy Preset Window) file
  • Share presets with others or backup your configurations
Import From File…
  • Import .klpw preset files
  • Access community-created presets
See Command Line Options for importing and loading presets via CLI.

​
Applying Changes

Changes made in Klassy Settings are applied according to the button you click: 
Applies changes immediately without closing the dialog

Applies changes and closes the dialog

Discards changes and closes the dialog

Resets all settings to Klassy defaults
Most decoration changes take effect immediately for new windows. Existing windows may need to be refreshed (minimize/restore) to show changes.

​
Configuration Files

Klassy Settings stores configuration in:
  • ~/.config/klassy/klassyrc - Main configuration file
  • ~/.config/klassy/windecopresetsrc - Saved presets
  • ~/.config/kwinrc - KWin window manager settings (border size, button layout)
These files use the KConfig INI-style format and can be manually edited if needed, though the GUI is recommended.