Omahub
← All plugins
L

Dual Monitor Workspaces

by Lukas Innig

Independent workspace banks, navigation, and indicators for dual-monitor Omarchy.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
09ffb24
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
09ffb24
Reviewed
1 month ago

The plugin is a benign QML bar widget that reads Hyprland workspace state and dispatches workspace activation clicks. It runs no shell commands during install or at runtimechers, has no network access, and touches no sensitive files. The README points to an external third-party Lua script (split-monitor-workspaces), but that is an opt-in example users must install separatelyadiance. The deterministic scan found no issues, and my independent review agrees.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/derluke/omarchy-dual-monitor-workspaces --enable
Desktop #Hyprland #quickshell #workspaces

Dual Monitor Workspaces for Omarchy

A complete dual-monitor workspace pattern for Omarchy Quattro: two independent five-workspace banks, predictable keyboard navigation, safe cross-monitor window movement, and workspace indicators scoped to each screen.

Dual-monitor workspace banks shown as five dots on each Omarchy bar

The included bar widget is the visual part of the setup. It shows five dots on each monitor; the focused workspace is bright, occupied workspaces are muted, and empty persistent workspaces are dim. Clicking a dot activates that monitor's corresponding Hyprland workspace.

Install

omarchy plugin add https://github.com/derluke/omarchy-dual-monitor-workspaces.git --enable
omarchy plugin disable omarchy.workspaces
omarchy bar move io.github.derluke.dual-monitor-workspaces --section left --after omarchy.menu

This installs the per-screen indicator without editing Hyprland. Complete the workspace setup below to enable independent workspace banks and shortcuts.

Configure dual-monitor workspaces

For five persistent workspaces per monitor, use the Lua version of split-monitor-workspaces. It requires Hyprland 0.55 or newer. Follow its release-branch guidance so the package version matches your installed Hyprland version.

An opt-in Omarchy example is included at examples/dual-monitor-workspaces.lua. Review it, replace the monitor names, and append it to ~/.config/hypr/bindings.lua. It configures:

  • Super+1..5: first monitor workspace 1..5
  • Super+Ctrl+1..5: second monitor workspace 1..5
  • Add Shift: move the active window and follow it
  • Add Shift+Alt: move the active window silently
  • Super+Tab / Super+Shift+Tab: cycle within the focused monitor
  • Super+Ctrl+Shift+Left/Right: move a window to a connected adjacent monitor

The directional move is guarded: it does nothing when no monitor exists in that direction.

Configure

The default maximum is five dots. Change it inline in ~/.config/omarchy/shell.json if desired:

{
  "id": "io.github.derluke.dual-monitor-workspaces",
  "count": 5
}

Persistent workspace rules are recommended so empty dots remain visible.

Remove

omarchy plugin remove io.github.derluke.dual-monitor-workspaces
omarchy plugin enable omarchy.workspaces --section left

Removing the widget does not remove any separately installed Hyprland package or changes copied manually from the example.

Permissions and dependencies

The bar component runs inside omarchy-shell, reads Quickshell's Hyprland workspace model, and dispatches workspace activation when clicked. It executes no shell commands, makes no network requests, and requires no elevated privileges.

Runtime requirements:

  • Omarchy 4 (Quattro)
  • The built-in Omarchy bar
  • Quickshell's Hyprland integration

The external split-monitor-workspaces Lua package provides the independent persistent workspace banks. The indicator can run without it, but the complete dual-monitor behavior documented by this project requires it.

License

MIT. This widget was derived from Omarchy's built-in workspace widget.