Menu bar items drawn as in the menu bar show the wrong part of the menu bar after a display change

Open
#820 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@Jonathanm10 is already working on this.

Since Nov 18, 2026.

  • #822 by @Jonathanm10 — open

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
35/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Stale
Tech stack
macos, swift
Domain
desktop, frontend

Research direction

Start with Sources/StableBar/MenuBarItemMirror.swift and trace how it caches SCWindow frames and chooses a window for capture. Compare those listed frames with the window server’s current bounds before capturing, then refresh the list when they differ. Done means live menu bar items remain aligned after a display disconnect or resolution change; issue #822 has an open linked pull request.

Written by the indexing model from the issue text.

Description

needs-triage
What happens

Items of a Menu bar items widget shown As in the menu bar ("display": "live") draw a slice of the macOS menu bar that belongs to other items after a display is disconnected or changes resolution. On a MacBook whose ultrawide monitor was unplugged, CodexBar's place on the bar showed the ChatGPT and MeetingBar icons and MeetingBar's place showed part of the Wi‑Fi and Sound icons. Each picture still opens its own item, so clicking the MeetingBar icon opens CodexBar and clicking the speaker opens MeetingBar. It stays that way until StableBar restarts.

Steps to reproduce
  1. On macOS 27, show two neighboring menu bar items on the bar with As in the menu bar, such as CodexBar and MeetingBar.
  2. Start StableBar while the display's menu bar is shorter than it will be later: on an external display without a notch (30 pt menu bar), or with the built-in display at a smaller "Looks like" resolution such as 1352 × 845.
  3. Disconnect the external display, or switch back to the default resolution (1512 × 982, 33 pt menu bar on a notched MacBook).
Expected

Each item shows what it shows in the macOS menu bar, at any display arrangement.

Environment

StableBar 0.18.0-beta.20261118082113.1362, macOS 27.2.1, MacBook Pro built-in display, ultrawide external monitor (3440 pt wide).

Evidence
  • The bar's log after the change shows ScreenCaptureKit capturing MenuBarAgent's window 118495 with frame=(0,0,3440,30) every two seconds, while the window server reports the same window at (0,0,1512,33).
  • Reproduced with the built-in display alone: started the installed build at 1352 × 845, switched to 1512 × 982 and captured the bar: its live items showed fragments of the neighboring icons. A build with the fix drew them correctly in the same run.
Diagnosis

MenuBarItemMirror (Sources/StableBar/MenuBarItemMirror.swift) keeps the SCWindows it listed and lists again only when none of their frames contains the item. MenuBarAgent keeps the same window when displays change and resizes it, so the cached frame still contains the item and is never refreshed. The capture uses that frame for its size, which scales the image (here by 30/33), so every item's crop lands about 9% too far right. It only shows when the window grows taller than when it was listed; a smaller window leaves the crops in place.

Fix: compare the listed frames with the window server's current bounds before capturing, and list again when they differ.

Related

#640 added the live copies. #799 asks for a widget-wide Show setting, unrelated.

Triaged by Claude Code (claude-opus-5-5).

Dominant language
Swift
Stars
184
Forks
12
Avg merge
3h 50m
Merged PRs (30d)
387

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Seb-GRAF/StableBar

All issues in Seb-GRAF/StableBar

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.