Button Customization

Customize titlebar button size, shape, colors, icons, and behavior

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:

Available Icon Styles

Kite (Default)

StyleKite - The default Kite icon style

Modern, clean icons designed to complement the Kite theme and Blue Ocean design refresh.

ButtonIconStyle=StyleKite

Suessig Kite

StyleSuessigKite - A sweeter variation of Kite icons

Softer, gentler variation of the Kite icon set.

ButtonIconStyle=StyleSuessigKite

Oxygen

StyleOxygen - Classic Oxygen icon style

Icons inspired by the classic KDE Oxygen theme.

ButtonIconStyle=StyleOxygen

Klasse

StyleKlasse - KDE 1-inspired icons

Nostalgic icons inspired by the original KDE 1 desktop environment.

ButtonIconStyle=StyleKlasse

Traditional

StyleTraditional - Traditional KDE styling

Classic, familiar icon shapes.

ButtonIconStyle=StyleTraditional

Metro

StyleMetro - Metro/Modern UI inspired

Flat, minimalist icons inspired by Microsoft Metro design.

ButtonIconStyle=StyleMetro

Fluent

StyleFluent - Microsoft Fluent Design inspired

Modern icons inspired by Microsoft Fluent Design.

ButtonIconStyle=StyleFluent

Ark Series

StyleArk, StyleArkopal, StyleArkopalLeft

Variants of the Ark icon style with different orientations.

ButtonIconStyle=StyleArkopal

Kisweet

StyleKisweet - Sweet, playful icons

ButtonIconStyle=StyleKisweet

System Icons

StyleSystemIconTheme - Use system icon theme

Display 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:

Integrated Rounded Rectangle (Default)

ShapeIntegratedRoundedRectangle

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

Integrated Rounded Rectangle Grouped

ShapeIntegratedRoundedRectangleGrouped

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

ButtonShape=ShapeIntegratedRoundedRectangleGrouped

Full-Height Rounded Rectangle

ShapeFullHeightRoundedRectangle

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

ButtonShape=ShapeFullHeightRoundedRectangle

Full-Height Rectangle

ShapeFullHeightRectangle

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

ButtonShape=ShapeFullHeightRectangle

Small Circle

ShapeSmallCircle

Circular button backgrounds. Featured in Classik-Aurorae preset.

ButtonShape=ShapeSmallCircle

Small Square

ShapeSmallSquare

Small square button backgrounds.

ButtonShape=ShapeSmallSquare

Small Rounded Square

ShapeSmallRoundedSquare

Small 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

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

Full-Height Buttons

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

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)

Inactive Windows

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:

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

ShowIconNormallyActive=true
ShowBackgroundNormallyActive=false
ShowOutlineNormallyActive=false

Hover State

ShowIconOnHoverActive=true
ShowBackgroundOnHoverActive=true
ShowOutlineOnHoverActive=true

Press State

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