A plain (non-floating, no pills) SketchyBar config in the Tokyo Night Storm palette, sized to sit exactly in the macOS reserved menu bar area.
The bar re-fits itself to the display, so the same config works at any resolution — the reserved top inset it must match is 38pt here and 32pt at the default (see Notes):
Scaled resolution, 1800×1169 — 38pt inset.
Default resolution, 1512×982 — 32pt inset, re-fitted on display_change.
brew install sketchybar jq blueutil nowplaying-cli
brew install --cask font-hack-nerd-font font-jetbrains-mono-nerd-font
xcode-select --install # swiftc, for the mic helper + display probeBoth Nerd Fonts are required — without them every icon renders as a blank box, with no other symptom.
git clone <this repo> ~/.config/sketchybar
brew services start sketchybar
~/.config/sketchybar/check.sh # verifies deps, parsing, and layoutbin/build.sh compiles the Swift helpers at startup if they are missing or
stale, so there is no build step. Only the .swift sources are tracked.
| Grant | Needed for | Without it |
|---|---|---|
| Microphone (your terminal, once) | — | Nothing; the mic indicator needs no grant |
| Accessibility → sketchybar | Lock and Force Quit in the menu |
Those two rows silently do nothing; the other eight work |
| Screen Recording → sketchybar | Nothing currently | Only needed if you add alias items to mirror menu bar extras |
Add the CLI binary itself, not a .app: $(brew --prefix)/bin/sketchybar.
Restart with brew services restart sketchybar after granting.
Left — power menu · focused app Right — now playing · CPU / memory · network (stacked ↑/↓) + Wi-Fi · Bluetooth / volume / battery · mic-in-use · clock
Interactive: click volume to mute (scroll to change), Bluetooth to toggle power, now-playing to play/pause, CPU/memory for Activity Monitor, clock for Calendar, Wi-Fi and battery for their Settings panes, mic for the privacy pane.
The mic indicator is hidden unless something is actually capturing, and the now-playing item hides itself when nothing is playing.
sketchybarrc opens with a fonts and measured widths block. The width
constants are not arbitrary — they are measured so labels never clip and never
shift the bar as digit counts change. If you change a font size, re-measure:
sketchybar --set volume label.width=-1 label="100%" # auto-size
sketchybar --query volume | jq '.bounding_rects' # read the widthcheck.sh asserts no clipping and no drift, so a bad constant fails loudly.
Colours live in colors.sh and are read by every plugin; swapping that one file
changes the whole theme.
Things that are not obvious and cost real time to work out:
- Bar height and the notch are queried, not hardcoded.
bin/screen-metrics.swiftreports the reserved top inset and notch bounds. The bar height must equal that inset or the bar either leaves a strip of desktop below it or overhangs the windows underneath. - The reserved inset changes with resolution, not just with hardware: 38pt
at 1800x1169 but 32pt at the default 1512x982 on the same MacBook. The startup
probe runs only at config load, so
plugins/display.shre-fits the height on thedisplay_changeevent. Point-based widths are unaffected by scaling. - Notch clearance shrinks as the resolution drops. At 1800pt wide the right
cluster clears the notch by ~150pt; at 1512pt only ~26pt.
check.shverifies it per display, so trim an item if it ever fails. notch_widthdoes not reflow left/right items. It only affects centre-positioned ones. Keeping items clear of the notch is a matter of bounding cluster widths —check.shverifies it per display.- Text scrolling needs
max_chars, notlabel.width. SketchyBar only animates strings it truncated itself.label.widthclips without scrolling. label.widthincludeslabel.padding_leftbut excludespadding_right;icon.widthincludesicon.padding_left. A too-smallicon.widthsilently eats the icon→label gap.- Positive
y_offsetmoves content up. Undocumented; verified on screen. - Only negative
padding_rightshifts an item in a right-anchored cluster. That is how the two throughput rows stack into one column. networksetup -getairportnetworkis broken on macOS 15 — it reports "not associated" while connected.wifi.shreadsipconfig getsummaryinstead.- No shell path to mic-in-use on Apple Silicon. There is no
IOAudioEngineStateinioreg;bin/mic-active.swiftreadskAudioDevicePropertyDeviceIsRunningSomewhere, the property behind the orange dot. CGSessionwas removed in macOS 15, soLockuses the Ctrl+Cmd+Q keystroke. If your screen-lock delay is not immediate, screensaver-based "locks" only blank the display.U+F8FF(the literal) is absent from Hack Nerd Font. The Apple glyph isU+F179. Glyphs prone to being dropped by editors are written as octal escapes and asserted byte-wise incheck.sh.- SketchyBar windows sit at layer −20, so
screencapturecannot see the bar — neither by region nor full screen. Verify rendering by eye. aliasitems are display-only. They mirror the image; clicks are not forwarded, so they do not restore reachability of hidden menu bar extras.
Palette: Tokyo Night (Storm). Bar: SketchyBar by Felix Kratz.


