feat(bar): add bar.screens to restrict the bar to specific monitors

[fivves]

Summary

The bar currently creates a panel on every connected screen (Variants { model: Quickshell.screens }). On multi-monitor setups there's no way to keep the bar on just one monitor — the only workaround is editing Bar.qml directly, which gets clobbered on every omarchy update. Waybar solved this years ago with a per-output config; this brings the same idea to shell.json.

Adds an optional bar.screens key: a list of Wayland output names the bar should be created on. Empty or omitted keeps the current behavior (bar on every screen).

{
  "bar": {
    "position": "top",
    "screens": ["DP-1"]
  }
}

Changes

• shell/plugins/bar/Bar.qml: new screenFilter/barScreens properties; all three per-screen Variants (BarPanel, DragGhostPanel, BarMoveGhostPanel) now bind to barScreens instead of Quickshell.screens directly
• shell/shell.qml: screens: [] in the builtin fallback config
• config/omarchy/shell.json: "screens": [] in the default config
• Docs updated in docs/omarchy-shell.md and shell/plugins/bar/README.md

Behavior

• Default: unchanged, one bar per screen
• "screens": ["DP-1"]: only DP-1 gets a bar; names match hyprctl monitors output
• Reactive: re-evaluates when screens hotplug or shell.json reloads, so changing the value moves the bar live without a shell restart

Testing

• qmllint passes on both modified QML files
• The filter expression is the same one I've been running on a dual-monitor setup (bar on DP-1 only, drag/move ghosts filtered too), verified working across shell restarts

[Copilot]

Pull request overview

Adds monitor-specific filtering for the built-in bar while preserving all-screen defaults.

Changes:

• Filters bar and ghost panels by configured output names.
• Adds default screens: [] configuration.
• Documents bar.screens.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
shell/plugins/bar/Bar.qml	Implements reactive screen filtering.
shell/shell.qml	Adds the fallback default.
config/omarchy/shell.json	Adds the shipped default.
shell/plugins/bar/README.md	Documents bar configuration.
docs/omarchy-shell.md	Documents the shell-level setting.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[fivves]

Addressed in 78a688c. Moved the filter logic from Bar.qml into BarModel.js (screenNames/screensFor) so it runs in the existing node harness, and added 11 assertions to test/shell.d/bar-test.sh covering omitted/empty filters, matching and non-matching output names, non-array tolerance, and all three per-screen Variants binding the configured filter. Caveat: this harness cannot execute QML, so live hotplug re-evaluation is not directly testable here — the barScreens binding references Quickshell.screens and barConfig directly, so it re-evaluates on screen changes and config reloads, and the structural wiring is now guarded by the suite.

[fivves]

Fixed in 78a688c. Rule 9 now scopes bar.screens to the built-in bar (omarchy.bar) and notes that replacement bar plugins receive barConfig but must implement the filtering themselves.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated no new comments.

Suppressed comments (1)

shell/plugins/bar/Bar.qml:56

• The filter only changes the three bar Variants, but the notification service still creates a popup on every Quickshell.screens output and always calls popupPlacement with the global bar clearance (shell/plugins/notifications/Service.qml:788-804). With screens: ["DP-1"], notifications on every other output remain displaced as though a top/right bar existed. Please expose/check whether modelData is included in the bar screen filter and use only the outer gap when that output has no bar.

  readonly property var barScreens: BarModel.screensFor(barConfig, Quickshell.screens)