[ryoku] qsbar: per-monitor workspace isolation (fixes #767) by Satirito · Pull Request #770 · Ryoku-dev/ryoku

Satirito · 2026-11-09T09:37:39Z

What changed

Implements per-monitor workspace isolation (isolateMonitors) for qsbar workspaces, addressing #767.

Added isolateMonitors boolean setting (default false) under qsbar.isolateMonitors in shell.json.
Exposed in catalogue widgets.json under workspaces, enabling CLI control via ryoku-shell bar set workspaces isolateMonitors on/off.
Added UI toggle in QS Bar Settings > Identity under Workspaces.
In multi-monitor setups with isolateMonitors enabled:
- Each bar displays only the workspaces assigned to its monitor across dynamic, active, and fixed (1-5, 1-10) modes.
- Each monitor highlights its own active workspace; the active marker dims to 72% opacity when the screen lacks keyboard focus.
The right-click WorkspacePanel popup also filters by screen when enabled.
Single-monitor setups and isolateMonitors: false retain 100% identical behavior.

Fixes #767

Area

ryoku

How it was tested

Added Go unit tests in ryoku/shell/ipc/bar_test.go (TestBarWorkspacesIsolateMonitors) verifying CLI toggling and round-tripping through the settings store (go test ./... in shell/ipc).
Validated all modified QML files (Theme.qml, BarSlot.qml, WorkspaceWidget.qml, WorkspacePanel.qml, IdentityRoute.qml) with qmllint (0 errors).

Checklist

One logical change, with a clear [area] scope: summary commit subject.
Matching CHANGELOG.md updated in the area I touched.
The git hooks pass locally; I did not use --no-verify.
Lua parses (luac -p), shell scripts pass bash -n, and QML passes qmllint where applicable.
No duplicated config, no dead code, no commented-out code, no em-dash.
Docs updated if behavior or layout changed.

…itors

… section

neur0map · 2026-11-09T09:39:50Z

🦊 mika's review

Incremental review: new commits since the last checkpoint.

Summary

Add optional per-monitor workspace isolation to QS Bar.
Show local active workspaces and dim unfocused monitor markers.
Expose the setting through Identity, CLI, and persistent configuration.
Add workspace isolation and CLI round-trip tests.

Change diagram

flowchart LR
  Settings["Identity settings / CLI"] --> Theme["Persisted QS Bar setting"]
  WM["WM workspace and output state"] --> Widget["Workspace widget"]
  WM --> Panel["Workspace popup"]
  Theme --> Widget
  Theme --> Panel
  Helper["Workspace isolation helper"] --> Widget

Estimated review effort: 2/5 · risk: medium

📁 Walkthrough details

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceIsolation.js`

Adds shared workspace selection and focus helpers for monitor isolation.
- Filters dynamic, active, and fixed workspace lists by output.
- Selects local active workspaces and calculates marker opacity.
- Preserves uncreated fixed slots and beyond-range active workspaces.

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceWidget.qml`

Applies monitor-aware workspace lists and active markers to the bar.
- Uses local active workspace and focused-output state when isolation is enabled.
- Dims active visuals on unfocused monitors, including Frame and Pacman styles.
- Avoids tracking live workspace lists in non-isolated fixed mode.

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/panels/WorkspacePanel.qml`

Filters the workspace popup by its screen when isolation is enabled.
- Sorts displayed workspaces and derives navigation IDs from the same list.
- Highlights the popup screen's active workspace.

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/Theme.qml`

Adds the default-off isolateMonitors setting and persists it in QS Bar configuration.
- Loads and writes qsbar.isolateMonitors.

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/BarSlot.qml`

Passes the bar's screen name to the workspace widget.
- Connects each widget instance to its output identity.

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/controlcenter/routes/IdentityRoute.qml`

Adds a per-monitor isolation toggle to Identity workspace settings.
- Binds the on/off control to isolateMonitors.

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/core/widgets.json`

Exposes workspace mode, style, and isolation settings in the widget catalogue.
- Enables catalogue-driven CLI control of isolateMonitors.

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceIsolation.test.mjs`

Adds tests for workspace selection, fixed slots, and monitor focus dimming.
- Covers local active workspaces, data dependencies, and beyond-range slots.

`ryoku/shell/ipc/bar_test.go`

Tests enabling and disabling isolation through the bar IPC command.
- Checks both values round-trip through the settings store.

`ryoku/i18n/catalog/en.json`

Adds English strings for the per-monitor setting and its explanation.
- Registers the new Identity settings text.

`CHANGELOG.md`

Documents workspace isolation, focus dimming, and configuration entry points.
- Adds an unreleased entry for issue 767.

Findings

Severity	Category	Fix effort	File	Issue
🟡 minor	correctness	medium	`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceWidget.qml`	Possible Bug — With isolation enabled, fixed modes depend on every `Wm.workspaces` update, and `workspaceList()` returns a new array even when the displayed IDs have not changed. Focus or occupancy updates can therefore reset the repea…
🟢 trivial	maintainability	low	`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/Theme.qml`	Maintainability — The new comment contains en-dash characters, which the repository's mechanical rules prohibit. Use ASCII punctuation instead.
🟢 trivial	maintainability	low	`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/controlcenter/routes/IdentityRoute.qml`	Maintainability — The new comment contains en-dash characters, which the repository's mechanical rules prohibit. Use ASCII punctuation instead.

⚡ Quick fixes by effort

Low effort (apply from the diff):

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/Theme.qml:2345 — Maintainability — The new comment contains en-dash characters, which the repository's mechanical rules prohibit. Use ASCII punctuation instead.
ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/controlcenter/routes/IdentityRoute.qml:307 — Maintainability — The new comment contains en-dash characters, which the repository's mechanical rules prohibit. Use ASCII punctuation instead.

Medium effort (a function-level change):

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceWidget.qml:41 — Possible Bug — With isolation enabled, fixed modes depend on every Wm.workspaces update, and workspaceList() returns a new array even when the displayed IDs have not changed. Focus or occupancy updates can therefore reset the repea…

🤖 Prompt for AI agents (click, copy, paste into Claude/Codex)

Fix the following issues found by mika-agent on Ryoku-dev/ryoku#770 (branch feat/qsbar-workspace-isolate-monitors):

- ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceWidget.qml:41-45 — Possible Bug (minor severity, medium effort): With isolation enabled, fixed modes depend on every `Wm.workspaces` update, and `workspaceList()` returns a new array even when the displayed IDs have not changed. Focus or occupancy updates can therefore reset the repea…

For each: verify it is real in the current code, apply the smallest correct fix, and run the repo's tests. Skip anything already resolved and say why.

🛠 Deterministic checks run

golangci-lint: not installed (skip)

🚦 Merge recommendation: needs_review

_{🦊 Generated by Mika — the Ryoku org's self-hosted AI code reviewer. Machine findings: verify before merging.}

neur0map

🔍 mika reviewed this change; details in the walkthrough comment.

neur0map · 2026-11-09T09:39:51Z

+                    title: I18n.tr("ISOLATE")
+                    kana: "\u5206"
+
+                    SettingRow {
+                        anchors.left: parent.left
+                        anchors.right: parent.right
+                        label: I18n.tr("Per-monitor")
+                        desc: I18n.tr("Each bar shows only the workspaces on its own screen.")


🟡 minor · Data Integrity · fix: medium effort

The new translation keys are not added to the source and English catalogs in this diff. The new settings card therefore lacks catalog entries for its title, label, and description, breaking translated-UI integrity.

Fixed. Added missing English catalog entries for "Per-monitor" and "Each bar shows only the workspaces on its own screen." in ryoku/i18n/catalog/en.json.

neur0map · 2026-11-09T09:39:51Z

+            if (!ws[i].special && ws[i].active && ws[i].output === wsWidget.screenName)
+                return ws[i]
+        }
+        return Wm.focusedWorkspace


🟡 minor · Possible Bug · fix: low effort

If no active workspace is found for a screen, this falls back to the globally focused workspace, which can belong to another screen. In fixed mode an out-of-range global workspace is then appended to that screen's list and highlighted, breaking isolation; return no local active workspace instead.

Suggested change

Suggested change

return Wm.focusedWorkspace

return null

Fixed. Returned null instead of falling back to Wm.focusedWorkspace when isolateMonitors is active but no monitor-active workspace is found.

neur0map · 2026-11-09T09:39:51Z

+                    continue
+                res.push(vs[i])
+            }
+            res.sort(function(x, y) { return Number(x.name) - Number(y.name) })


🟡 minor · Possible Bug · fix: medium effort

The popup now sorts its visible workspaces even when isolation is disabled, whereas previously it displayed Wm.workspaces in provider order. If the provider returns a non-numeric order, opening the popup changes the displayed order despite isolation being off; preserve the original order in that mode.

Fixed. Only sort filteredWorkspaces when isolateMonitors is enabled, preserving original provider order when disabled.

…dev#767)

neur0map

🔍 mika reviewed this change; details in the walkthrough comment.

neur0map · 2026-11-09T10:32:11Z

        readonly property var wsIds: {
            var a = []
-            var vs = Wm.workspaces
-            for (var i = 0; i < vs.length; i++) if (!vs[i].special) a.push(vs[i].name)
-            a.sort(function(x, y) { return Number(x) - Number(y) })
+            var vs = card.filteredWorkspaces
+            for (var i = 0; i < vs.length; i++) a.push(vs[i].name)
+            if (!root.isolateMonitors) {
+                a.sort(function(x, y) { return Number(x) - Number(y) })
+            }


🟡 minor · Possible Bug · fix: low effort

When isolation is off, the repeater preserves Wm.workspaces order but wsIds is sorted separately. If the compositor returns workspaces out of numeric order, keyboard navigation moves through them in a different order from the displayed rows. Use the same ordered model for both display and navigation.

…cePanel Always sort filteredWorkspaces numerically (not only when isolateMonitors is on) so the repeater and wsIds are always in the same order. wsIds is now derived directly from filteredWorkspaces without an independent sort, which fixes keyboard navigation when the compositor returns workspaces out of numeric order and isolation is off. Addresses mika review finding on PR Ryoku-dev#770.

Satirito · 2026-11-09T10:37:00Z

Fixed in b753286.

The root cause: wsIds was sorted independently from filteredWorkspaces, so the two could diverge whenever the compositor returned workspaces out of numeric order and isolation was off — breaking keyboard navigation.

Fix applied:

filteredWorkspaces now always sorts numerically (guard if (root.isolateMonitors) removed).
wsIds is now a pure map over filteredWorkspaces, deriving names in the same order the repeater renders them.

This guarantees the two arrays are always aligned, so keyboard Up/Down always selects the visually highlighted row.

neur0map

🔍 mika reviewed this change; details in the walkthrough comment.

neur0map · 2026-11-09T10:38:14Z

+// TestBarWorkspacesIsolateMonitors verifies that the isolateMonitors toggle
+// is accepted by the bar-set verb and round-trips through the settings store.
+func TestBarWorkspacesIsolateMonitors(t *testing.T) {


🟡 minor · Tests · fix: medium effort

The new test only checks persistence through the CLI, leaving the workspace filtering and per-monitor active marker untested. Add coverage for multiple outputs, including uncreated fixed-mode workspaces and focus changes.

neur0map

🔍 mika reviewed this change; details in the walkthrough comment.

neur0map · 2026-11-09T10:53:04Z

+    readonly property var workspaceList: WorkspaceIsolation.workspaceList(
+        Wm.workspaces, root.workspaceMode, wsWidget.dynamicModel, wsWidget.screenName,
+        root.isolateMonitors, root.isolateMonitors ? wsWidget.monitorActiveWs : Wm.focusedWorkspace)


🟡 minor · Possible Bug · fix: medium effort

In fixed workspace modes, this binding now depends directly on Wm.focusedWorkspace and returns a new array on every focus change, even when the displayed workspace IDs are unchanged. Replacing the Repeater model recreates its delegates, interrupting their focus animations; the previous extraWs property avoided model changes for in-range switches. Keep the model stable when its IDs have not changed.

neur0map

🔍 mika reviewed this change; details in the walkthrough comment.

neur0map · 2026-11-09T11:32:04Z

+    readonly property var workspaceList: WorkspaceIsolation.workspaceList(
+        Wm.workspaces, root.workspaceMode, wsWidget.dynamicModel, wsWidget.screenName,
+        root.isolateMonitors, wsWidget.listActiveWorkspace, wsWidget.extraWs)


🟡 minor · Possible Bug · fix: medium effort

In fixed workspace modes, workspaceList now depends on Wm.workspaces even when isolation is disabled. A workspace update therefore produces a new array and resets the Repeater model, recreating delegates and interrupting their focus animations; the previous fixed model stayed stable for in-range focus changes. Avoid depending on the live workspace list in fixed mode when isolation is off.

neur0map

🔍 mika reviewed this change; details in the walkthrough comment.

neur0map · 2026-11-09T17:34:20Z



-            // ── PREVIEW ──
+            // ── workspaces: ISOLATE ──


🟢 trivial · Maintainability · fix: low effort

The new comment contains en-dash characters, which the repository's mechanical rules prohibit. Use ASCII punctuation instead.

Suggested change

Suggested change

// ── workspaces: ISOLATE ──

// Workspaces: ISOLATE

Reply here to discuss, say it's fixed, or explain why it's intended — no mention needed.

Satirito added 7 commits November 9, 2026 10:35

[ryoku] qsbar: add isolateMonitors toggle to workspaces catalogue

5691e26

[ryoku] qsbar/Theme: add isolateMonitors property with persistence

6f868a3

[ryoku] qsbar/BarSlot: thread screenName into WorkspaceWidget

b354fa0

[ryoku] qsbar/WorkspaceWidget: per-monitor filtering and focus dimming

fc60a1e

[ryoku] qsbar/WorkspacePanel: filter popup by monitor when isolateMon…

7744fcd

…itors

[ryoku] qsbar/IdentityRoute: add isolateMonitors toggle in Workspaces…

4818296

… section

[docs] changelog: document qsbar isolateMonitors (Ryoku-dev#767)

8b1c349

neur0map reviewed Nov 9, 2026

View reviewed changes

[ryoku] qsbar: address review feedback on workspace isolation (Ryoku-…

1776900

…dev#767)

neur0map reviewed Nov 9, 2026

View reviewed changes

[ryoku] qsbar: cover per-monitor workspace isolation

538c985

neur0map reviewed Nov 9, 2026

View reviewed changes

[ryoku] qsbar: keep fixed workspace model stable

3ce7431

neur0map reviewed Nov 9, 2026

View reviewed changes

[ryoku] qsbar: avoid live workspace model resets

fa291b4

neur0map reviewed Nov 9, 2026

View reviewed changes

Update Theme.qml

b413662



		// ── PREVIEW ──
		// ── workspaces: ISOLATE ──

Conversation

Satirito commented Nov 9, 2026

What changed

Area

How it was tested

Checklist

Uh oh!

neur0map commented Nov 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦊 mika's review

Summary

Change diagram

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceIsolation.js

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceWidget.qml

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/panels/WorkspacePanel.qml

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/Theme.qml

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/BarSlot.qml

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/controlcenter/routes/IdentityRoute.qml

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/core/widgets.json

ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceIsolation.test.mjs

ryoku/shell/ipc/bar_test.go

ryoku/i18n/catalog/en.json

CHANGELOG.md

Findings

⚡ Quick fixes by effort

Uh oh!

neur0map left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

🟡 minor · Data Integrity · fix: medium effort

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

🟡 minor · Possible Bug · fix: low effort

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

🟡 minor · Possible Bug · fix: medium effort

Uh oh!

Choose a reason for hiding this comment

Uh oh!

neur0map left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

🟡 minor · Possible Bug · fix: low effort

Uh oh!

Satirito commented Nov 9, 2026

Uh oh!

neur0map left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

🟡 minor · Tests · fix: medium effort

Uh oh!

neur0map left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

🟡 minor · Possible Bug · fix: medium effort

Uh oh!

neur0map left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

🟡 minor · Possible Bug · fix: medium effort

Uh oh!

neur0map left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

🟢 trivial · Maintainability · fix: low effort

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

neur0map commented Nov 9, 2026 •

edited

Loading

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceIsolation.js`

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceWidget.qml`

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/panels/WorkspacePanel.qml`

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/Theme.qml`

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/BarSlot.qml`

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/controlcenter/routes/IdentityRoute.qml`

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/core/widgets.json`

`ryoku/shell/quickshell/shell/modules/bar/barstyles/qsbar/modules/WorkspaceIsolation.test.mjs`

`ryoku/shell/ipc/bar_test.go`

`ryoku/i18n/catalog/en.json`

`CHANGELOG.md`