Very simple replacement for Workspaces.qml that allows workspace assignment and control by monitor

[techistory]

This routine (Workspaces.qml) is a slight enhancement of the stock Workspaces.qml file so you can assign a fixed subset of workspaces to
each of your several monitors. In this bespoke example I have workspace 1 assigned to my laptop, then 2-4 to secondary monitor DP-6, 5-9 to DP-3 and 10-12 to DP-4. Switching between workspaces is predictable when clicking on the omarchy bar, and I can navigate and control all of my monitors, windows and workspaces very easily with SUPER, SHIFT, ALT and function keys F1-F12.

Not fancy. No bells and whistles. No GUI config. Just a tiny bit of manual setup to match your system.

1. Clone original: omarchy plugin clone omarchy.workspaces

This command creates a local copy of the plugin in ~/.config/omarchy/plugins/<username>.workspaces/,
renames it (e.g., "user.Workspaces"), enables it, and switches the shell to use your clone.

2. Replace the cloned version with the Workspaces.qml code below.
3. Replace "user" with your userid in moduleName (in BarWidget) below.
4. Adjust various name === 'monitor name" statements in function workspaceIds (below) for your desired workspaces per monitor.
5. Enter omarchy-restart-shell whenever you want to "swap in" your latest change. You may need to use hyprctl reload for the lua stuff.
6. Create workspaces.lua to match. Make sure to update hyprland.lua to require it. Example that matches this code:

workspaces.lua

hl.workspace_rule({ workspace = "1", monitor = "eDP-1", default = true })

hl.workspace_rule({ workspace = "2", monitor = "DP-6", default = true })
hl.workspace_rule({ workspace = "3", monitor = "DP-6" })
hl.workspace_rule({ workspace = "4", monitor = "DP-6" })

hl.workspace_rule({ workspace = "5", monitor = "DP-3", default = true })
hl.workspace_rule({ workspace = "6", monitor = "DP-3" })
hl.workspace_rule({ workspace = "7", monitor = "DP-3" })
hl.workspace_rule({ workspace = "8", monitor = "DP-3" })
hl.workspace_rule({ workspace = "9", monitor = "DP-3" })

hl.workspace_rule({ workspace = "10", monitor = "DP-4", default = true })
hl.workspace_rule({ workspace = "11", monitor = "DP-4" })
hl.workspace_rule({ workspace = "12", monitor = "DP-4" })

7. Create matching binds. Here are some that use the 12 Function keys (F1-F12):

bindings.lua

-- F1-F12
-- Switch to numeric workspace
local mainMod = "SUPER"

hl.bind(mainMod .. " + code:67", hl.dsp.focus({ workspace = "1" }))

hl.bind(mainMod .. " + code:68", hl.dsp.focus({ workspace = "2" }))
hl.bind(mainMod .. " + code:69", hl.dsp.focus({ workspace = "3" }))
hl.bind(mainMod .. " + code:70", hl.dsp.focus({ workspace = "4" }))

hl.bind(mainMod .. " + code:71", hl.dsp.focus({ workspace = "5" }))
hl.bind(mainMod .. " + code:72", hl.dsp.focus({ workspace = "6" }))
hl.bind(mainMod .. " + code:73", hl.dsp.focus({ workspace = "7" }))
hl.bind(mainMod .. " + code:74", hl.dsp.focus({ workspace = "8" }))
hl.bind(mainMod .. " + code:75", hl.dsp.focus({ workspace = "9" }))

hl.bind(mainMod .. " + code:76", hl.dsp.focus({ workspace = "10" }))
hl.bind(mainMod .. " + code:95", hl.dsp.focus({ workspace = "11" }))
hl.bind(mainMod .. " + code:96", hl.dsp.focus({ workspace = "12" }))

-- Move current window and focus to numeric workspace
hl.bind(mainMod .. " + SHIFT + code:67", hl.dsp.window.move({ workspace = "1" }))

hl.bind(mainMod .. " + SHIFT + code:68", hl.dsp.window.move({ workspace = "2" }))
hl.bind(mainMod .. " + SHIFT + code:69", hl.dsp.window.move({ workspace = "3" }))
hl.bind(mainMod .. " + SHIFT + code:70", hl.dsp.window.move({ workspace = "4" }))

hl.bind(mainMod .. " + SHIFT + code:71", hl.dsp.window.move({ workspace = "5" }))
hl.bind(mainMod .. " + SHIFT + code:72", hl.dsp.window.move({ workspace = "6" }))
hl.bind(mainMod .. " + SHIFT + code:73", hl.dsp.window.move({ workspace = "7" }))
hl.bind(mainMod .. " + SHIFT + code:74", hl.dsp.window.move({ workspace = "8" }))
hl.bind(mainMod .. " + SHIFT + code:75", hl.dsp.window.move({ workspace = "9" }))

hl.bind(mainMod .. " + SHIFT + code:76", hl.dsp.window.move({ workspace = "10" }))
hl.bind(mainMod .. " + SHIFT + code:95", hl.dsp.window.move({ workspace = "11" }))
hl.bind(mainMod .. " + SHIFT + code:96", hl.dsp.window.move({ workspace = "12" }))

-- Move current window (but not focus) to numeric workspace
hl.bind(mainMod .. " + SHIFT + ALT + code:67", hl.dsp.window.move({ workspace = "1", follow = false }), { locked = true })

hl.bind(mainMod .. " + SHIFT + ALT + code:68", hl.dsp.window.move({ workspace = "2", follow = false }), { locked = true })
hl.bind(mainMod .. " + SHIFT + ALT + code:69", hl.dsp.window.move({ workspace = "3", follow = false }), { locked = true })
hl.bind(mainMod .. " + SHIFT + ALT + code:70", hl.dsp.window.move({ workspace = "4", follow = false }), { locked = true })

hl.bind(mainMod .. " + SHIFT + ALT + code:71", hl.dsp.window.move({ workspace = "5", follow = false }), { locked = true })
hl.bind(mainMod .. " + SHIFT + ALT + code:72", hl.dsp.window.move({ workspace = "6", follow = false }), { locked = true })
hl.bind(mainMod .. " + SHIFT + ALT + code:73", hl.dsp.window.move({ workspace = "7", follow = false }), { locked = true })
hl.bind(mainMod .. " + SHIFT + ALT + code:74", hl.dsp.window.move({ workspace = "8", follow = false }), { locked = true })
hl.bind(mainMod .. " + SHIFT + ALT + code:75", hl.dsp.window.move({ workspace = "9", follow = false }), { locked = true })

hl.bind(mainMod .. " + SHIFT + ALT + code:76", hl.dsp.window.move({ workspace = "10", follow = false }), { locked = true })
hl.bind(mainMod .. " + SHIFT + ALT + code:95", hl.dsp.window.move({ workspace = "11", follow = false }), { locked = true })
hl.bind(mainMod .. " + SHIFT + ALT + code:96", hl.dsp.window.move({ workspace = "12", follow = false }), { locked = true })

Workspaces.qml

import QtQuick
import QtQuick.Layouts
import Quickshell.Hyprland
import qs.Commons
import qs.Ui

BarWidget {
  id: root
  moduleName: "user.workspaces"

  onBarChanged: {
    var ids = root.workspaceIds()
    workspaceRepeater.model = ids
  }

  function workspaceById(id) {
    var values = Hyprland.workspaces.values
    for (var i = 0; i < values.length; i++) {
      if (values[i].id === id) return values[i]
    }

    return null
  }

  function workspaceIds() {
    if (!root.bar) {
        console.log("WS NO BAR")
        return []
    }

    // This is the ModuleSlot belonging to THIS Workspaces instance.
    var mySlot = root.parent ? root.parent.parent : null

    if (!mySlot) {
        console.log("WS NO MY SLOT")
        return []
    }

    var myWindow = root.bar.slotWindow(mySlot)

    if (!myWindow) {
        console.log("WS MY WINDOW IS NULL")
        return []
    }

    if (!myWindow.screen) {
        console.log("WS MY WINDOW HAS NO SCREEN")
        return []
    }

    var name = myWindow.screen.name

    if (name === "eDP-1")
        return [1]

    if (name === "DP-6")
        return [2, 3, 4]

    if (name === "DP-3")
        return [5, 6, 7, 8, 9]

    if (name === "DP-4")
        return [10, 11, 12]

    console.log("WS UNKNOWN SCREEN:", name)
    return []
  }

  function focusWorkspace(id) {
    if (!root.bar) return
    root.bar.run("hyprctl dispatch " + Util.shellQuote("hl.dsp.focus({ workspace = \"" + id + "\" })"))
  }

  readonly property real trailingGap: root.vertical ? 0 : Style.spaceReal(1.5)

  implicitWidth: grid.implicitWidth + trailingGap
  implicitHeight: grid.implicitHeight

  GridLayout {
    id: grid

    anchors.fill: parent
    anchors.rightMargin: root.trailingGap
    columns: root.vertical ? 1 : root.workspaceIds().length
    columnSpacing: root.vertical ? 0 : Style.space(1)
    rowSpacing: root.vertical ? Style.space(2) : 0

    Repeater {
      id: workspaceRepeater
      model: root.workspaceIds()

      WidgetButton {
        required property int modelData

        readonly property var workspace: root.workspaceById(modelData)
        readonly property bool occupied: workspace !== null && workspace.toplevels.values.length > 0
        readonly property bool focused: Hyprland.focusedWorkspace !== null && Hyprland.focusedWorkspace.id === modelData

        bar: root.bar
        // text: focused ? "\uDB85\uDCFB" : (modelData === 10 ? "0" : String(modelData))
        text: focused ? "\uDB85\uDCFB" : String(modelData)
        opacity: occupied || focused ? 1 : 0.5
        horizontalMargin: 6
        verticalPadding: 6
        fixedWidth: root.vertical ? root.barSize : Style.space(20)
        fixedHeight: root.barSize
        onPressed: function() { root.focusWorkspace(modelData) }
      }
    }
  }
}

[sgruendel]

I have a PR open in #7243 that would provide that feature out of the box.

[techistory]

Stefan,

Thank you for the heads up. Looking forward to this being a native feature. Frankly, I was obsessed with getting this working after the upgrade to Quatro broke it. (I was somehow able to get this behavior in version 3 with no effort). I'm a retired developer from the IBM mainframe days with almost zero experience with lua, qml, Github, etc. So, I bit the bullet, and for 3-4 hours I used ChatGPT on Omarchy to guide me through the code and config changes to make this work for me.

I will be checking out your other work, studying your code and following your PR with great interest.

Mit freundlichen Grüßen,
Len