Omahub
← All plugins
O

i3 Workspaces

by Omarchy

i3bar-style workspace number indicators, per-monitor

GitHub

Security review

Review recommended · 4 findings

Deterministic scan — not a security guarantee

Medium
Risk level
Medium
Analyzed commit
2f80781
Scanned
1 month ago

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

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

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
2f80781
Reviewed
1 month ago

The plugin is a straightforward QML bar widget that displays per-monitor workspace numbers and dispatches hyprctl commands on click. The deterministic scan flagged sudo/apt-get usage, but those are in a GitHub Actions CI workflow that never runs on a user's machine, not in the plugin runtime. The QML code is clean, uses shell quoting for the dispatch command, and contains no obfuscation, persistence, or destructive behavior.

  • The CI workflow uses sudo apt-get, but it only runs in GitHub Actions, not on user systems.
  • The plugin executes hyprctl dispatch commands, which is expected for a workspace switcher and is properly shell-quoted.
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/coquer/i3-workspaces --enable
Desktop #workspaces

i3 Workspaces

An Omarchy bar widget: i3bar-style workspace numbers, one per monitor.

Stock omarchy.workspaces shows the same global workspace list on every bar surface, which falls apart once a second monitor is attached -- both bars end up showing identical numbers regardless of which monitor a workspace actually lives on. This widget filters to the monitor each bar instance is drawn on, so each screen shows only its own workspaces, and marks the one that's actually active on that monitor with a solid accent-filled pill.

i3-workspaces on two monitors: eDP-1 showing 1 2 3 with 2 active, HDMI-A-2 showing 4 active

Install

omarchy plugin add https://github.com/coquer/i3-workspaces.git --enable

Or install manually: clone or copy this repo directly into the plugins directory as i3-workspaces:

cp -r i3-workspaces ~/.config/omarchy/plugins/

~/.config/omarchy/plugins/ is scanned one level deep (<pluginsDir>/*/manifest.json), so manifest.json and Workspaces.qml have to sit directly inside ~/.config/omarchy/plugins/i3-workspaces/ -- not nested inside a wrapper directory.

Then add it to the bar's left section in ~/.config/omarchy/shell.json:

{ "id": "i3-workspaces" }

If the stock omarchy.workspaces widget is still in that section too, take it out -- otherwise both render side by side and you get every workspace number twice.

Reload the shell to pick up the change:

pkill -f "quickshell -n -p /usr/share/omarchy/shell"

Quickshell relaunches on its own (this is normal on Omarchy).

Remove

omarchy plugin remove i3-workspaces

Or, if installed manually, delete the folder and drop the shell.json entry:

rm -rf ~/.config/omarchy/plugins/i3-workspaces

Use

Click a number to focus that workspace. Numbers belonging to other monitors never show up on a bar that isn't theirs -- each monitor only lists the workspaces Hyprland has assigned to it, plus whichever workspace is currently active there (so the bar never renders empty).

The active workspace on each monitor gets a solid accent pill regardless of which monitor currently holds keyboard focus -- i.e. jumping your focus to a second monitor doesn't gray out the workspace you left behind on the first one. Text-color-only highlighting was tried first and dropped: several themes use an accent close enough to the muted gray that the "active" state was hard to read at bar font size, so a background fill was used instead for a signal that survives any theme.

Settings

Set in the widget's entry in shell.json:

{ "id": "i3-workspaces", "maxWorkspaceId": 10 }
Key Default Meaning
maxWorkspaceId 10 Highest workspace number shown. Workspace 10 always renders as 0, matching Hyprland's default keybinds.

How the per-monitor filtering works

Each bar surface is a separate instance of this widget, one per monitor. It reads its own output name off QsWindow.window.screen.name and filters Hyprland.workspaces down to whatever Hyprland reports as that workspace's owning monitor (workspace.monitor.name, falling back to the raw IPC payload). The monitor's own active workspace comes from Hyprland.monitors rather than the globally focused workspace, since those diverge the moment a second monitor exists.

QsWindow carries no change-notification, so reading it into a cached readonly property at binding time can freeze at an empty screen name if the widget evaluates before it's fully parented into its window -- this widget reads it fresh inside a function on every recompute instead of caching it.

License

MIT