Skip to main content
The klassy-settings command supports several command-line options for automation, scripting, and headless configuration management.

​
Display Help

View all available command-line options: 
klassy-settings --help
This displays the usage information, available options, and version information.

​
Version Information

Display the Klassy version: 
klassy-settings --version

​
Import Preset

Import a Klassy preset file (.klpw) into your preset library without launching the GUI.

​
Basic Import

klassy-settings --import-preset /path/to/preset.klpw
Short form: 
klassy-settings -i /path/to/preset.klpw

​
Import Behavior

1

File validation

The preset file is validated to ensure it’s a valid Klassy Preset with the correct structure
2

Version check

The preset version is compared against the current Klassy version
3

Name conflict handling

If a preset with the same name exists, you’ll be prompted whether to overwrite (when using GUI)When using CLI, the import will fail with an error message
4

Import completion

The preset is added to ~/.config/klassy/windecopresetsrc

​
Force Import from Different Version

If you’re importing a preset created for a different Klassy version, use the force flag: 
klassy-settings --import-preset /path/to/preset.klpw --force-import-invalid-version
Short form: 
klassy-settings -i /path/to/preset.klpw -f
Forcing import of presets from different versions may result in missing or incompatible settings. Use with caution.

​
Import Error Messages

ERROR: Invalid Klassy Preset file to import at "/path/to/preset.klpw".

​
Success Message

On successful import: 
Preset, "Preset Name" imported.

​
Load Preset

Load and apply a window decoration preset from your library by name.

​
Basic Usage

klassy-settings --load-windeco-preset "Preset Name"
Short form: 
klassy-settings -w "Preset Name"

​
Load Behavior

1

Import bundled presets

Bundled presets are automatically imported/updated to ensure they’re available
2

Validate preset exists

The command checks that the named preset exists in ~/.config/klassy/windecopresetsrc
3

Load and save configuration

The preset settings are loaded and saved to ~/.config/klassy/klassyrc
4

Reload KWin

KWin configuration is reloaded via D-Bus to apply window border and button layout changes
5

Generate system icons

System icons are automatically regenerated based on the preset’s button style

​
Examples

# Load the default Kite preset
klassy-settings --load-windeco-preset "Kite"

# Load ClassiK v3 preset
klassy-settings --load-windeco-preset "ClassiK v3"

# Load a custom preset
klassy-settings --load-windeco-preset "My Custom Style"

​
Available Built-in Presets

Some of the bundled presets you can load:
  • Kite - Default pragmatic theme
  • Kite Light - Light variant of Kite
  • ClassiK v3 - Full-height rounded rectangles
  • ClassikStyles - Rectangle button highlights
  • Classik-Aurorae - Circular button highlights
  • Glassy Klassy - Translucent glass effect
  • Chroma - Colorful accents
  • Opal Fruits - Vibrant colors
  • KDE1 - Classic KDE 1 style
  • Klasse - KDE 1 inspired
To see all available presets, open the Presets dialog in the klassy-settings GUI.

​
Error Messages

ERROR: Preset, "Preset Name" not found.

​
Success Message

Preset, "Preset Name" loaded...
klassy and klassy-dark system icons generated.

​
Generate System Icons

Regenerate the klassy and klassy-dark system icon themes based on current settings.

​
Basic Usage

klassy-settings --generate-system-icons
Short form: 
klassy-settings -g

​
What It Does

1

Read current settings

Loads button icon style and color configuration from ~/.config/klassy/klassyrc
2

Generate icon theme directories

Creates/updates icon theme directories:
  • ~/.local/share/icons/klassy/
  • ~/.local/share/icons/klassy-dark/
3

Render window control icons

Generates SVG icons for all window controls:
  • window-close, window-minimize, window-maximize
  • window-restore, window-keep-above, window-keep-below
  • window-shade, window-unshade
  • application-menu
  • Plus -symbolic variants
4

Create HiDPI variants

Generates icons at multiple scales (1x, 1.25x, 1.5x, 1.75x, 2x, 2.25x, 2.5x, 2.75x, 3x)
5

Create index.theme files

Writes icon theme metadata with inheritance configuration

​
When to Use

Regenerate system icons when:
  • You’ve changed the button icon style in Klassy Settings
  • You’ve modified button colors
  • Icons appear outdated or incorrect in menus/GTK applications
  • After manually editing configuration files
Icon generation is automatically triggered when loading a preset with --load-windeco-preset, so manual generation is only needed if you change settings without loading a preset.

​
Success Message

klassy and klassy-dark system icons generated.

​
Combining Options

You can combine certain options in a single command: 
# Import and immediately load a preset, generating icons
klassy-settings --import-preset ~/Downloads/mytheme.klpw \
                --load-windeco-preset "My Theme"

# Load preset and explicitly regenerate icons
klassy-settings -w "Glassy Klassy" -g
When combining options, they are processed in order: import → load → generate icons.

​
Scripting Examples

​
Automated Theme Switching

#!/bin/bash
# Switch between day and night themes

HOUR=$(date +%H)

if [ $HOUR -ge 6 ] && [ $HOUR -lt 18 ]; then
    klassy-settings -w "Kite Light"
else
    klassy-settings -w "Kite"
fi

​
Batch Import Presets

#!/bin/bash
# Import all preset files from a directory

for preset in ~/KlassyPresets/*.klpw; do
    echo "Importing $preset..."
    klassy-settings -i "$preset"
done

​
Reset to Defaults

# Load the default Kite preset to reset customizations
klassy-settings -w "Kite" && klassy-settings -g

​
Exit Codes

The command returns standard exit codes:
  • 0 - Success
  • 1 - Error occurred (invalid file, preset not found, etc.)
This allows for error handling in scripts: 
if klassy-settings -i mypreset.klpw; then
    echo "Import successful"
    klassy-settings -w "MyPreset"
else
    echo "Import failed" >&2
    exit 1
fi