Button Customization

Overview

Klassy offers arguably the most comprehensive titlebar button customization of any KDE theme. You can control every aspect of button appearance and behavior, from icon styles to shapes to colors to hover effects.

Button Icon Styles

Klassy provides numerous built-in perfectly-pixel-snapped button icon sets: Button icons menu

Available Icon Styles

StyleKite - The default Kite icon styleModern, clean icons designed to complement the Kite theme and Blue Ocean design refresh. Default Integrated Rounded rectangle button style, dark

Default Integrated Rounded rectangle button style, dark

ButtonIconStyle=StyleKite

StyleSuessigKite - A sweeter variation of Kite iconsSofter, gentler variation of the Kite icon set.

ButtonIconStyle=StyleSuessigKite

StyleOxygen - Classic Oxygen icon styleIcons inspired by the classic KDE Oxygen theme.

ButtonIconStyle=StyleOxygen

StyleKlasse - KDE 1-inspired iconsNostalgic icons inspired by the original KDE 1 desktop environment.

ButtonIconStyle=StyleKlasse

StyleTraditional - Traditional KDE stylingClassic, familiar icon shapes.

ButtonIconStyle=StyleTraditional

StyleMetro - Metro/Modern UI inspiredFlat, minimalist icons inspired by Microsoft Metro design.

ButtonIconStyle=StyleMetro

StyleFluent - Microsoft Fluent Design inspiredModern icons inspired by Microsoft Fluent Design.

ButtonIconStyle=StyleFluent

StyleArk, StyleArkopal, StyleArkopalLeftVariants of the Ark icon style with different orientations.

ButtonIconStyle=StyleArkopal

StyleKisweet - Sweet, playful icons Kisweet preset

ButtonIconStyle=StyleKisweet

StyleSystemIconTheme - Use system icon themeDisplay window-*-symbolic icons from your system icon theme.

ButtonIconStyle=StyleSystemIconTheme
ForceColorizeSystemIcons=true

Enable “Force Colorize System Icons” to ensure icons match your color scheme.

Button Shapes

Choose from multiple button background shapes:

ShapeIntegratedRoundedRectangle Default Integrated Rounded rectangle button style, dark

Default shape with translucent outlined accent colors and large clickable area. Designed to complement the Blue Ocean refresh.

ButtonShape=ShapeIntegratedRoundedRectangle
IntegratedRoundedRectangleBottomPadding=1.5  # 0-20

ShapeIntegratedRoundedRectangleGroupedSimilar to integrated rounded rectangles, but buttons are grouped together.

ButtonShape=ShapeIntegratedRoundedRectangleGrouped

ShapeFullHeightRoundedRectangle Rounded rectangle button style

Classic full-height buttons with rounded corners. Featured in the ClassiK v3 preset.

ButtonShape=ShapeFullHeightRoundedRectangle

ShapeFullHeightRectangle Square highlight style

Sharp rectangular buttons extending the full titlebar height. Featured in ClassikStyles preset.

ButtonShape=ShapeFullHeightRectangle

ShapeSmallCircle Circle button highlight style

Circular button backgrounds. Featured in Classik-Aurorae preset.

ButtonShape=ShapeSmallCircle

ShapeSmallSquareSmall square button backgrounds.

ButtonShape=ShapeSmallSquare

ShapeSmallRoundedSquareSmall square backgrounds with rounded corners.

ButtonShape=ShapeSmallRoundedSquare

Button Sizing

Icon Size

Choose from 10 predefined icon sizes:

IconSize=IconLargeMedium  # Default

Available sizes (smallest to largest):

IconTiny
IconVerySmall
IconSmall
IconSmallMedium
IconMedium
IconLargeMedium (default)
IconLarge
IconVeryLarge
IconGiant
IconHumongous

System Icon Size

When using StyleSystemIconTheme, set the pixel size:

SystemIconSize=SystemIcon16  # Default

Available: 8, 12, 14, 16 (default), 18, 20, 22, 24, 32, 48 pixels

Background Scale

For small button shapes, adjust the background size:

ScaleBackgroundPercent=100  # 100-250%

Button Spacing

Non-Full-Height Buttons
Full-Height Buttons

ButtonSpacingLeft=6          # 0-100
ButtonSpacingRight=10        # 0-100
LockButtonSpacingLeftRight=false

FullHeightButtonWidthMarginLeft=6      # 0-100
FullHeightButtonWidthMarginRight=18    # 0-100
LockFullHeightButtonWidthMargins=false

FullHeightButtonSpacingLeft=2          # 0-100
FullHeightButtonSpacingRight=4         # 0-100
LockFullHeightButtonSpacingLeftRight=false

Button Corner Radius

Control button corner roundness:

ButtonCornerRadius=SameAsWindow  # or Custom
ButtonCustomCornerRadius=2.5     # 0-24.0 (when Custom)

Touch Mode Scaling

Increase button size for touch screens:

ScaleTouchMode=150  # 100-400%

Button Colors

Icon Colors

Choose color schemes for button icons:

Active Windows
Inactive Windows

ButtonIconColorsActive=TitleBarText

Available options:

TitleBarText - Matches titlebar text color (default)
TitleBarTextNegativeClose - Titlebar text, red close button
Accent - System accent color
AccentNegativeClose - Accent with red close
AccentTrafficLights - Traffic light colors (red/yellow/green)

ButtonIconColorsInactive=TitleBarText
LockButtonColorsActiveInactive=true

Set the lock to use the same colors for active and inactive windows.

Background Colors

ButtonBackgroundColorsActive=AccentNegativeClose
ButtonBackgroundColorsInactive=AccentNegativeClose

Background colors support the same options as icon colors: TitleBarText, TitleBarTextNegativeClose, Accent, AccentNegativeClose, AccentTrafficLights.

Traffic Lights Mode

Enable macOS-style traffic light button colors: Traffic lights button style

ButtonBackgroundColorsActive=AccentTrafficLights

This mode colors the close button red, maximize yellow, and minimize green.

Opacity Settings

Control icon and background transparency:

ButtonIconOpacityActive=100        # 0-100%
ButtonIconOpacityInactive=100      # 0-100%
ButtonBackgroundOpacityActive=60   # 0-100%
ButtonBackgroundOpacityInactive=60 # 0-100%

Contrast Enhancement

Klassy automatically enhances contrast when needed:

# For icon contrast
OnPoorIconContrastActive=TitleBarBackground
PoorIconContrastThresholdActive=1.5  # 1.0-21.0

# For background contrast
AdjustBackgroundColorOnPoorContrastActive=true
PoorBackgroundContrastThresholdActive=1.1  # 1.0-21.0

Options for poor icon contrast:

Nothing - No adjustment
BlackWhite - Switch to black or white
TitleBarBackground - Use titlebar background color (default)

Close Button Customization

The close button can have separate styling:

Close Icon Color

CloseButtonIconColorActive=WhiteWhenHoverPress

Options:

AsSelected - Same as other buttons
NegativeWhenHoverPress - Red when hovered/pressed
White - Always white
WhiteWhenHoverPress - White when hovered/pressed (default)

Close Background Behavior

NegativeCloseBackgroundHoverPressActive=false

When true, the close button shows a negative (red) background on hover/press.

Button Behavior

Control what appears in different button states (normal, hover, press):

Standard Buttons

Normal State
Hover State
Press State

ShowIconNormallyActive=true
ShowBackgroundNormallyActive=false
ShowOutlineNormallyActive=false

ShowIconOnHoverActive=true
ShowBackgroundOnHoverActive=true
ShowOutlineOnHoverActive=true

ShowIconOnPressActive=true
ShowBackgroundOnPressActive=true
ShowOutlineOnPressActive=true

Close Button Separate Behavior

LockCloseButtonBehaviourActive=true  # Lock to same as other buttons

When unlocked, you can set separate behavior:

ShowCloseIconNormallyActive=true
ShowCloseBackgroundNormallyActive=false
ShowCloseIconOnHoverActive=true
ShowCloseBackgroundOnHoverActive=true
# etc.

Color Variation on Hover

Make buttons change color dynamically:

VaryColorIconActive=No           # Default: no variation
VaryColorBackgroundActive=Opaque # Default: become opaque
VaryColorOutlineActive=Opaque    # Default: become opaque

Variation options:

No - No variation
Opaque / MostOpaqueHover - Increase opacity
Transparent / MostTransparentHover - Decrease opacity
Light / LightestHover - Lighten color
Dark / DarkestHover - Darken color
MoreTitleBar / MostTitleBarHover - Blend toward titlebar color
LessTitleBar / LeastTitleBarHover - Blend away from titlebar

Bold Button Icons

Control icon line weight:

BoldButtonIcons=BoldIconsActiveHiDpi

Options:

BoldIconsBold - Always bold
BoldIconsFine - Always fine/thin
BoldIconsHiDpiOnly - Bold only on HiDPI displays
BoldIconsActive - Bold only on active windows
BoldIconsActiveHiDpi - Bold on active windows with HiDPI (default)

Per-Button Color Override

You can override colors for individual button types:

ButtonOverrideColorsActiveClose=255,0,0        # Red close button
ButtonOverrideColorsActiveMinimize=255,255,0   # Yellow minimize
# etc.

Available button types:

Menu
ApplicationMenu
OnAllDesktops
Minimize
Maximize
Close
ContextHelp
Shade
KeepBelow
KeepAbove

Unison Hovering

Make all buttons respond to hover when any button is hovered:

UnisonHovering=false  # Default: independent hover

Unison hovering can be visually distracting and is disabled by default.

Next Steps

Window Decorations

Customize titlebar and window styling

Animations

Configure button and window animations

Get Started

Theming

Configuration

Guides

Button Customization

Overview

Button Icon Styles

Available Icon Styles

Button Shapes

Button Sizing

Icon Size

System Icon Size

Background Scale

Button Spacing

Button Corner Radius

Touch Mode Scaling

Button Colors

Icon Colors

Background Colors

Traffic Lights Mode

Opacity Settings

Contrast Enhancement

Close Button Customization

Close Icon Color

Close Background Behavior

Button Behavior

Standard Buttons

Close Button Separate Behavior

Color Variation on Hover

Bold Button Icons

Per-Button Color Override

Unison Hovering

Next Steps

Window Decorations

Animations

Build docs developers (and LLMs) love

Get Started

Theming

Configuration

Guides

Documentation Index

​Overview

​Button Icon Styles

​Available Icon Styles

​Button Shapes

​Button Sizing

​Icon Size

​System Icon Size

​Background Scale

​Button Spacing

​Button Corner Radius

​Touch Mode Scaling

​Button Colors

​Icon Colors

​Background Colors

​Traffic Lights Mode

​Opacity Settings

​Contrast Enhancement

​Close Button Customization

​Close Icon Color

​Close Background Behavior

​Button Behavior

​Standard Buttons

​Close Button Separate Behavior

​Color Variation on Hover

​Bold Button Icons

​Per-Button Color Override

​Unison Hovering

​Next Steps

Window Decorations

Animations

Build docs developers (and LLMs) love

Overview

Button Icon Styles

Available Icon Styles

Button Shapes

Button Sizing

Icon Size

System Icon Size

Background Scale

Button Spacing

Button Corner Radius

Touch Mode Scaling

Button Colors

Icon Colors

Background Colors

Traffic Lights Mode

Opacity Settings

Contrast Enhancement

Close Button Customization

Close Icon Color

Close Background Behavior

Button Behavior

Standard Buttons

Close Button Separate Behavior

Color Variation on Hover

Bold Button Icons

Per-Button Color Override

Unison Hovering

Next Steps