Klassy provides fine-grained control over titlebar spacing, button positioning, and title alignment. All measurements scale properly for HiDPI displays.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.
Titlebar Margins
Top margin of the titlebar in pixels. Creates spacing between the top of the window and titlebar content.
- Min: 0
- Max: 50
- Default: 3.6
Bottom margin of the titlebar in pixels. Creates spacing between titlebar content and the window content area.
- Min: 0
- Max: 50
- Default: 3.6
When enabled, top and bottom margins are synchronized - changing one automatically updates the other.
Left side margin of the titlebar in pixels.
- Min: 0
- Max: 60
Right side margin of the titlebar in pixels.
- Min: 0
- Max: 60
When enabled, left and right margins are synchronized.
Maximized Window Margins
Percentage of normal top/bottom margins to use for maximized windows. Allows maximized windows to have tighter spacing.
- Min: 0 (no margins when maximized)
- Max: 100 (same margins as normal windows)
- Default: 85
Title Alignment
Controls the horizontal alignment of the window title text.
Alignment Options
Alignment Options
Align title to the left side of the available space (after left buttons).
Center title within the available space between left and right buttons.
Default. Center title across the full titlebar width, potentially overlapping button areas.
Align title to the right side of available space (before right buttons).
Horizontal padding around the title text in pixels.
- Min: 0
- Max: 60
- Default: 4
Button Spacing (Small Shapes)
These settings apply to non-full-height button shapes (small circle, square, rounded square, and integrated rectangles).Spacing to the left of each button in pixels.
- Min: 0
- Max: 100
- Default: 6
Spacing to the right of each button in pixels.
- Min: 0
- Max: 100
- Default: 10
When enabled, left and right button spacing values are synchronized.
Button Spacing (Full-Height Shapes)
These settings apply to full-height rectangular and rounded rectangular button shapes.Spacing to the left of each full-height button in pixels.
- Min: 0
- Max: 100
- Default: 2
Spacing to the right of each full-height button in pixels.
- Min: 0
- Max: 100
- Default: 4
When enabled, left and right spacing for full-height buttons are synchronized.
Full-Height Button Width
Left width margin for full-height buttons in pixels. Controls the horizontal padding inside the button.
- Min: 0
- Max: 100
- Default: 6
Right width margin for full-height buttons in pixels.
- Min: 0
- Max: 100
- Default: 18
When enabled, left and right width margins are synchronized.
Percentage width of close button relative to other full-height buttons. Allows making the close button wider for easier clicking.
- Min: 25 (1/4 size)
- Max: 400 (4x size)
- Default: 100 (same as other buttons)
Spacer Button
Width of spacer buttons as a percentage of normal button width. Spacer buttons create visual separation in button layouts.
- Min: 1 (nearly invisible)
- Max: 400 (4x normal width)
- Default: 50 (half width)
Spacing values work together to create the overall titlebar layout. Full-height and small button shapes have independent spacing controls because they have different design requirements.
Visual Examples
The README shows the spacing and alignment controls in action:
Related Settings
- Button Shapes - Different shapes have different spacing controls
- Button Styles - Icon size affects spacing appearance
- Window Outline - Window borders and outline spacing