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.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/paulmcauley/klassy/llms.txt
Use this file to discover all available pages before exploring further.
Launching Klassy Settings
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:Choose from built-in perfectly-pixel-snapped button icons or
window-*-symbolic system iconsOptions include:
- Integrated Rounded Rectangles (default)
- Full-height Rounded Rectangle
- Full-height Rectangle
- Circular
Set the corner radius for windows (pixels, scaled for HiDPI)
When enabled, the titlebar inherits colors from the application’s header area
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
- Configure button size, spacing, and clickable area
- Adjust button aspect ratio and padding
- Customize colors for each button type (Close, Minimize, Maximize, etc.)
- Configure hover and pressed states
- Set up “traffic lights” color scheme or custom palettes
- Control button hover animations
- Configure background colors and opacity
- Set outline styles and thickness
- Adjust titlebar margins (sides, top/bottom)
- Configure different spacing for maximized windows
- Set button spacing (left and right)
- Configure transparency for active/inactive windows
- Set opacity for maximized windows separately
- Enable/disable blur effects
- Configure thin window outlines
- Set accent colors and blending modes
- Adjust outline thickness
- Configure window shadow appearance
- Adjust shadow size, offset, and opacity
Animations Tab
Toggle button and titlebar animations on/off
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
Presets
Using Presets
Klassy includes numerous built-in presets that apply coordinated style configurations: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…
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
- Delete custom presets you’ve created
- Built-in bundled presets cannot be removed
- Export a preset to a
.klpw(Klassy Preset Window) file - Share presets with others or backup your configurations
- Import
.klpwpreset files - Access community-created presets
Applying Changes
Changes made in Klassy Settings are applied according to the button you click: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)