sborders

Window borders for macOS.

sborders draws configurable borders around application windows, follows focus and window movement, and reloads JSONC configuration while running. It works alongside swm, skbd, and sbar without requiring a particular window manager.

Quick start

Requires macOS 26 or later. Building requires Swift 6.2 or later.

make build
.build/debug/sborders

The default border is four points wide, with a light active colour and transparent inactive colour. Create ~/.config/sborders/config.jsonc to change it:

{
  "width": 4,
  "activeColor": "#89B4FA",
  "inactiveColor": "#45475A80"
}

Start with --config to use another file. The default focus mode does not request Accessibility permission. See getting started for configuration paths and development for the current validation record and private API limitations.

Documentation

• Documentation index
• Configuration
• Command line
• Development and validation
• Sample configuration