# FelixKratz/JankyBorders

A lightweight window border system for macOS

Repository: https://github.com/FelixKratz/JankyBorders
Canonical: https://ross.abutalabs.com/products/jankyborders
Language: C
License: GPL-3.0
License Family: copyleft
Topics: border, customization, macos, tiling-window-manager, window-border, yabai, fast, lightweight
Last push: 2026-05-14T12:26:18+00:00

## Health v2 (maintenance only)
Score: 70/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 82, release rhythm 52, longevity 73
- inputs: {"age_days": 1035, "days_push": 111, "days_rel": 111, "gap_med": 270.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3753, forks 86 (observed 2026-08-28T04:08:17.762700+00:00)

## What it is
JankyBorders is a lightweight macOS tool that draws colored borders around windows to visually highlight the focused window. It works without the accessibility API, making it faster than comparable tools, and integrates easily with tiling window managers like yabai and AeroSpace.

## Use cases
- highlight the focused window on macOS with a colored border
- customize window border colors, width, and style on macOS
- add window borders alongside yabai tiling window manager
- add window borders alongside AeroSpace window manager
- run borders as a background service via brew services
- change border appearance at runtime without restarting

## When to choose
- you use a tiling window manager like yabai or AeroSpace on macOS 14+ and want visual focus indication
- you want a fast, lightweight border tool that avoids the accessibility API
- you want configurable border colors, styles, and widths with runtime updates

## When to avoid
- you are on macOS older than 14.0
- you need window management features beyond borders, such as tiling itself
- you need cross-platform window decoration on Linux or Windows

## Facets
- artifact type: application
- maturity: stable
- function: gui, developer-tools
- domain: desktop-applications, developer-tools, windows
- platform: cli
- tags: window-border, yabai, aerospace, tiling-window-manager, desktop-customization, macos

## Member repositories
- FelixKratz/JankyBorders (main) score 70

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:17.762700+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:28:57.317087+00:00, confidence not recorded.
  - readme: https://github.com/FelixKratz/JankyBorders (fetched 2026-08-28T04:08:17.762700+00:00, sha a6e7ef97edd0)
- Data as of 2026-08-30T08:39:29.467469+00:00.