Skip to main content

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.

Klassy provides extensive customization for titlebar button appearance, including multiple icon styles, size options, and advanced color configurations.

​
Icon Styles

​
ButtonIconStyle
enum
default:"StyleKite"
Selects the visual style for button icons. Klassy provides numerous built-in perfectly-pixel-snapped icon styles, plus the ability to use system icon themes.
​
StyleSystemIconTheme
option
Use window-*-symbolic icons from the system icon theme. Allows integration with custom icon themes.
​
StyleKite
option
Default. Modern icon style for the main Kite global theme. Clean, contemporary design.
​
StyleSuessigKite
option
Sweet variation of the Kite icon style with softer curves.
​
StyleOxygen
option
Classic Oxygen desktop icon style, familiar to long-time KDE users.
​
StyleKlasse
option
Inspired by KDE 1, offering a retro aesthetic with modern refinement.
​
StyleTraditional
option
Traditional window decoration icons.
​
StyleMetro
option
Metro/Modern UI inspired minimalist icons.
​
StyleFluent
option
Microsoft Fluent Design inspired icons.
​
StyleArk
option
Ark icon style with centered design.
​
StyleArkopal
option
Arkopal icon style variation.
​
StyleArkopalLeft
option
Arkopal style with left-aligned icons.
​
StyleKisweet
option
Sweet, rounded icon style.

​
Icon Size

​
IconSize
enum
default:"IconLargeMedium"
Controls the size of button icons (for built-in icon styles).
  • IconTiny - Smallest size
  • IconVerySmall
  • IconSmall
  • IconSmallMedium
  • IconMedium - Medium size
  • IconLargeMedium - Default
  • IconLarge
  • IconVeryLarge
  • IconGiant
  • IconHumongous - Largest size
​
SystemIconSize
enum
default:"SystemIcon16"
Icon size when using StyleSystemIconTheme. Specified in pixels.
  • SystemIcon8 - 8px
  • SystemIcon12 - 12px
  • SystemIcon14 - 14px
  • SystemIcon16 - Default 16px
  • SystemIcon18 - 18px
  • SystemIcon20 - 20px
  • SystemIcon22 - 22px
  • SystemIcon24 - 24px
  • SystemIcon32 - 32px
  • SystemIcon48 - 48px
​
ForceColorizeSystemIcons
bool
default:"true"
When enabled, colorizes icons from the system icon theme to match the configured button colors. Disable to preserve the original icon colors.

​
Icon Weight

​
BoldButtonIcons
enum
default:"BoldIconsActiveHiDpi"
Controls the boldness/weight of button icons.
​
BoldIconsBold
option
Always use bold/thick icon strokes.
​
BoldIconsFine
option
Always use fine/thin icon strokes.
​
BoldIconsHiDpiOnly
option
Use bold icons only on HiDPI displays.
​
BoldIconsActive
option
Use bold icons only for active windows.
​
BoldIconsActiveHiDpi
option
Default. Use bold icons for active windows on HiDPI displays.

​
Icon Colors

​
ButtonIconColors
enum
default:"TitleBarText"
Base color scheme for button icons. This setting has separate values for active and inactive windows (ButtonIconColorsActive and ButtonIconColorsInactive).
​
TitleBarText
option
Default. Use titlebar text color for icons.
​
TitleBarTextNegativeClose
option
Titlebar text color, with negative/red color for close button.
​
Accent
option
Use system accent color.
​
AccentNegativeClose
option
Accent color with negative/red close button.
​
AccentTrafficLights
option
Accent color with macOS-style traffic light colors (red/yellow/green).
​
CloseButtonIconColor
enum
default:"WhiteWhenHoverPress"
Special color handling for the close button icon. Separate settings for active/inactive windows.
​
AsSelected
option
Use the color from ButtonIconColors setting.
​
NegativeWhenHoverPress
option
Use negative/red color when hovering or pressing.
​
White
option
Always use white color.
​
WhiteWhenHoverPress
option
Default. Use white when hovering or pressing the button.

​
Icon Opacity

​
ButtonIconOpacity
int
default:"100"
Opacity percentage for button icons. Separate values for active (ButtonIconOpacityActive) and inactive (ButtonIconOpacityInactive) windows.
  • Min: 0 (fully transparent)
  • Max: 100 (fully opaque)
  • Default: 100

​
Poor Contrast Handling

​
OnPoorIconContrast
enum
default:"TitleBarBackground"
Action to take when button icon contrast is poor. Separate settings for active/inactive windows.
​
Nothing
option
Do nothing, keep original colors even with poor contrast.
​
BlackWhite
option
Switch to black or white to improve contrast.
​
TitleBarBackground
option
Default. Add titlebar background color behind icon to improve contrast.
​
PoorIconContrastThreshold
double
default:"1.5"
Contrast ratio threshold below which icon contrast is considered poor. Based on WCAG contrast calculations.
  • Min: 1.0 (no contrast)
  • Max: 21.0 (maximum contrast)
  • Default: 1.5

​
Background Colors

​
ButtonBackgroundColors
enum
default:"AccentNegativeClose"
Color scheme for button backgrounds. Separate values for active and inactive windows.
  • TitleBarText - Titlebar text color
  • TitleBarTextNegativeClose - Titlebar text with red close
  • Accent - System accent color
  • AccentNegativeClose - Default Accent with red close
  • AccentTrafficLights - Traffic light colors (red/yellow/green)
​
ButtonBackgroundOpacity
int
default:"60"
Opacity percentage for button backgrounds. Separate values for active/inactive windows.
  • Min: 0 (invisible background)
  • Max: 100 (solid background)
  • Default: 60
​
NegativeCloseBackgroundHoverPress
bool
default:"false"
Use negative/red color for close button background when hovering or pressing. Separate settings for active/inactive windows.
​
UseHoverAccent
bool
default:"false"
Use system hover accent color for button backgrounds on hover. Separate settings for active/inactive windows.
​
AdjustBackgroundColorOnPoorContrast
bool
default:"true"
Automatically adjust background color when contrast with titlebar is poor. Separate settings for active/inactive windows.
​
PoorBackgroundContrastThreshold
double
default:"1.1"
Contrast ratio threshold for poor background contrast.
  • Min: 1.0
  • Max: 21.0
  • Default: 1.1

​
Color Locking

​
LockButtonColorsActiveInactive
bool
default:"true"
When enabled, active and inactive window buttons use the same colors.
​
ButtonColorsInactiveSameHoverPress
bool
default:"true"
For inactive windows, use the same colors for hover and press states.
Klassy provides highly granular color control with separate settings for active/inactive windows and normal/hover/press states. The settings above are the base values - many have Active and Inactive variants in the configuration.

​
Touch Mode Scaling

​
ScaleTouchMode
int
default:"150"
Scale percentage for button sizes in touch mode, making buttons easier to tap on touchscreens.
  • Min: 100 (normal size)
  • Max: 400 (4x larger)
  • Default: 150 (1.5x larger)

Build docs developers (and LLMs) love

Get started for freeTalk to us