Multi-head workspace setup in Omarchy

[rsd]

Hello,

I compiled some defaults for a better multi-head setup in Omarchy.

I understand that @dhh and a lot of folks enjoy the single head setup.
I do like it too, but sometimes, I want to plug my notebook to my big monitor, or to have a portrait monitor for writing docs or reading.

Whatever the case might be, the Omarchy defaults for a multi-head are not very good.
Workspaces get messy as which one is in which monitor and no keybinds to (for example) move a window to a empty monitor workspace.

So, I wrote a small guide to what I think is a better setup in Omarchy for a multi-head workspace setup.

Goal

• Better manage a multi-head setup.
• Avoid the inconsistency of which monitor has workspace X.
• Each Monitor to has its own set of workspaces.
• Switch focus between monitors.
• Move windows direct to another monitor.

Updated Keybidings

SUPER + CTRL to handle monitor interaction.

To focus desired monitor:
SUPER + CTRL + < monitor index >
SUPER + CTRL + LEFT/RIGHT

To move a window to the a monitor:
(even if the current workspace is empty)
SUPER + CTRL + SHIFT + < monitor index >
SUPER + CTRL + SHIFT + LEFT/RIGHT

Plugin

split-monitor-workspaces

Dependencies

sudo pacman -S cpio

Update headers

hyprpm update

Install

hyprpm add https://github.com/Duckonaut/split-monitor-workspaces
hyprpm enable split-monitor-workspaces
hyprpm reload -n

Configuration

Add in ~/.config/hypr/hyprland.conf:

# Plugins Configurtion
source = ~/.config/hypr/plugin-split-monitor-workspace.conf

Create ~/.config/hypr/plugin-split-monitor-workspace.conf:

# Auto-load plugins on startup (recommended by Hyprland)
exec-once = hyprpm reload -n

# --- split-monitor-workspaces ---
plugin {
  split-monitor-workspaces {
    count = 10
    keep_focused = 1
    enable_persistent_workspaces = 0
    enable_notifications = 0
  }
}

# unbind Omarchy defaults without touching them
unbind = SUPER, code:10
unbind = SUPER, code:11
unbind = SUPER, code:12
unbind = SUPER, code:13
unbind = SUPER, code:14
unbind = SUPER, code:15
unbind = SUPER, code:16
unbind = SUPER, code:17
unbind = SUPER, code:18
unbind = SUPER, code:19

unbind = SUPER SHIFT, code:10
unbind = SUPER SHIFT, code:11
unbind = SUPER SHIFT, code:12
unbind = SUPER SHIFT, code:13
unbind = SUPER SHIFT, code:14
unbind = SUPER SHIFT, code:15
unbind = SUPER SHIFT, code:16
unbind = SUPER SHIFT, code:17
unbind = SUPER SHIFT, code:18
unbind = SUPER SHIFT, code:19


##### WORKSPACES (per monitor, via plugin) #####
# SUPER + [1..0] = switch workspace on current monitor
bindd = SUPER, code:10, Switch WS 1, split-workspace, 1
bindd = SUPER, code:11, Switch WS 2, split-workspace, 2
bindd = SUPER, code:12, Switch WS 3, split-workspace, 3
bindd = SUPER, code:13, Switch WS 4, split-workspace, 4
bindd = SUPER, code:14, Switch WS 5, split-workspace, 5
bindd = SUPER, code:15, Switch WS 6, split-workspace, 6
bindd = SUPER, code:16, Switch WS 7, split-workspace, 7
bindd = SUPER, code:17, Switch WS 8, split-workspace, 8
bindd = SUPER, code:18, Switch WS 9, split-workspace, 9
bindd = SUPER, code:19, Switch WS 0, split-workspace, 10

# SUPER + SHIFT + [1..0] = move window to workspace (keep focus here)
bindd = SUPER SHIFT, code:10, Move win to WS 1, split-movetoworkspace, 1
bindd = SUPER SHIFT, code:11, Move win to WS 2, split-movetoworkspace, 2
bindd = SUPER SHIFT, code:12, Move win to WS 3, split-movetoworkspace, 3
bindd = SUPER SHIFT, code:13, Move win to WS 4, split-movetoworkspace, 4
bindd = SUPER SHIFT, code:14, Move win to WS 5, split-movetoworkspace, 5
bindd = SUPER SHIFT, code:15, Move win to WS 6, split-movetoworkspace, 6
bindd = SUPER SHIFT, code:16, Move win to WS 7, split-movetoworkspace, 7
bindd = SUPER SHIFT, code:17, Move win to WS 8, split-movetoworkspace, 8
bindd = SUPER SHIFT, code:18, Move win to WS 9, split-movetoworkspace, 9
bindd = SUPER SHIFT, code:19, Move win to WS 0, split-movetoworkspace, 10

# Cycle workspaces on current monitor
bindd = SUPER, TAB, Cycle WS next, split-cycleworkspaces, next
bindd = SUPER SHIFT, TAB, Cycle WS prev, split-cycleworkspaces, prev

##### ABSOLUTE MONITOR FOCUS (SUPER + CTRL + <position>)
bindd = SUPER CTRL, code:10, Focus mon 0, focusmonitor, 0
bindd = SUPER CTRL, code:11, Focus mon 1, focusmonitor, 1
bindd = SUPER CTRL, code:12, Focus mon 2, focusmonitor, 2
bindd = SUPER CTRL, code:13, Focus mon 3, focusmonitor, 3
bindd = SUPER CTRL, code:14, Focus mon 4, focusmonitor, 4

##### MOVE WINDOW TO MONITOR (by ID, keep focus here)
# SUPER+CTRL+SHIFT+[1..3]
bindd = SUPER CTRL SHIFT, code:10, Send win to mon 0, movewindow, mon:0
bindd = SUPER CTRL SHIFT, code:11, Send win to mon 1, movewindow, mon:1
bindd = SUPER CTRL SHIFT, code:12, Send win to mon 2, movewindow, mon:2
bindd = SUPER CTRL SHIFT, code:13, Send win to mon 3, movewindow, mon:3
bindd = SUPER CTRL SHIFT, code:14, Send win to mon 4, movewindow, mon:4

##### ARROW NAV (relative; monitor-agnostic) #####
# SUPER + LEFT/RIGHT = focus monitor left/right
bindd = SUPER CTRL, LEFT, Focus monitor left, focusmonitor, l
bindd = SUPER CTRL, RIGHT, Focus monitor right, focusmonitor, r

# SUPER + SHIFT + LEFT/RIGHT = send window to prev/next monitor
bindd = SUPER CTRL SHIFT, LEFT, Send win to left mon, movewindow, mon:l
bindd = SUPER CTRL SHIFT, RIGHT, Send win to right mon, movewindow, mon:r

Waybar

Update Waybar to better reflect it in ~/.config/waybar/style.css:

...
  "hyprland/workspaces": {
    "all-outputs": false,            // per-monitor list
    "sort-by-number": true,
    "disable-scroll": true,          // avoid scroll jumps
    "format": "{icon}",

    // Dots: filled = active here, ring = active elsewhere, hollow = has windows, dim = empty
    "format-icons": {
      "urgent":  "",
      "active":  "",  // current monitor's focused WS
      "visible": "",  // focused WS on another monitor
      "default": "",  // has windows
      "empty":   "·"   // created by split-monitor-workspaces but empty
    }
  },
...

[tonimarmol]

Thanks for sharing it! It's works perfect.

[jpSkipper]

Thank you very much. One small thing, i was a little bit confused by:

...Waybar
Update Waybar to better reflect it in ~/.config/waybar/style.css:
...
I guess you mean the ~/.config/waybar/config.jsonc instead of the css file.

[opajanvv]

A few comments:

• When installing the dependencies, I had to install: cpio, cmake, and meson.
• I recommend creating the new config for split-monitor-workspace first, and then adding the source command to hyprland.conf. That avoids a nasty error message that stays on your screen until you save hyprland.conf again.
• And @jpSkipper is right about editing the config instead of the stylesheet.

Anyway, thanks a lot for this walkthrough! Really helpful. Without it, I would have ditched Omarchy because of the lack of good workspace management in a dual-screen setup.

I changed the setup to my own preferences:

• Workspaces 1..4 on the first screen, workspaces 5..8 on the other
• SUPER + jumps to the proper workspace, no matter on which monitor it is
• SUPER SHIFT + moves the current window to the new workspace, even when it is on the other monitor
• Proper workspace cycling when using SUPER TAB
• Highlight the current workspace in waybar
• Waybar shows all workspaces (not only the ones having a window)

It took me a few hours to get this working properly, so I'll share my source files.

plugin-split-monitor-workspace.conf

# Auto-load plugins on startup (recommended by Hyprland)
exec-once = hyprpm reload -n

# --- split-monitor-workspaces ---
plugin {
  split-monitor-workspaces {
    count = 4
    keep_focused = 1
    enable_persistent_workspaces = 1
    enable_notifications = 1
    enable_wrapping = 1
  }
}

# unbind Omarchy defaults without touching them
unbind = SUPER, code:10
unbind = SUPER, code:11
unbind = SUPER, code:12
unbind = SUPER, code:13
unbind = SUPER, code:14
unbind = SUPER, code:15
unbind = SUPER, code:16
unbind = SUPER, code:17
unbind = SUPER, code:18
unbind = SUPER, code:19

unbind = SUPER SHIFT, code:10
unbind = SUPER SHIFT, code:11
unbind = SUPER SHIFT, code:12
unbind = SUPER SHIFT, code:13
unbind = SUPER SHIFT, code:14
unbind = SUPER SHIFT, code:15
unbind = SUPER SHIFT, code:16
unbind = SUPER SHIFT, code:17
unbind = SUPER SHIFT, code:18
unbind = SUPER SHIFT, code:19

##### WORKSPACES (per monitor, via plugin) #####
# WS 1–4 on monitor 0
bindd = SUPER, code:10, WS1, exec, hyprctl dispatch focusmonitor 0; hyprctl dispatch split-workspace 1
bindd = SUPER, code:11, WS2, exec, hyprctl dispatch focusmonitor 0; hyprctl dispatch split-workspace 2
bindd = SUPER, code:12, WS3, exec, hyprctl dispatch focusmonitor 0; hyprctl dispatch split-workspace 3
bindd = SUPER, code:13, WS4, exec, hyprctl dispatch focusmonitor 0; hyprctl dispatch split-workspace 4

# WS 5–8 on monitor 1
bindd = SUPER, code:14, WS5, exec, hyprctl dispatch focusmonitor 1; hyprctl dispatch split-workspace 1
bindd = SUPER, code:15, WS6, exec, hyprctl dispatch focusmonitor 1; hyprctl dispatch split-workspace 2
bindd = SUPER, code:16, WS7, exec, hyprctl dispatch focusmonitor 1; hyprctl dispatch split-workspace 3
bindd = SUPER, code:17, WS8, exec, hyprctl dispatch focusmonitor 1; hyprctl dispatch split-workspace 4

# SUPER + SHIFT + [1..8] = move window to workspace (and move focus there)
# WS 1–4 on monitor 0
bindd = SUPER SHIFT, code:10, Move win to WS 1, exec, hyprctl dispatch movewindow mon:0; hyprctl dispatch focusmonitor 0; hyprctl dispatch split-movetoworkspace 1
bindd = SUPER SHIFT, code:11, Move win to WS 2, exec, hyprctl dispatch movewindow mon:0; hyprctl dispatch focusmonitor 0; hyprctl dispatch split-movetoworkspace 2
bindd = SUPER SHIFT, code:12, Move win to WS 3, exec, hyprctl dispatch movewindow mon:0; hyprctl dispatch focusmonitor 0; hyprctl dispatch split-movetoworkspace 3
bindd = SUPER SHIFT, code:13, Move win to WS 4, exec, hyprctl dispatch movewindow mon:0; hyprctl dispatch focusmonitor 0; hyprctl dispatch split-movetoworkspace 4

# WS 5–8 on monitor 1 → remap to local 1–4
bindd = SUPER SHIFT, code:14, Move win to WS 5, exec, hyprctl dispatch movewindow mon:1; hyprctl dispatch focusmonitor 1; hyprctl dispatch split-movetoworkspace 1
bindd = SUPER SHIFT, code:15, Move win to WS 6, exec, hyprctl dispatch movewindow mon:1; hyprctl dispatch focusmonitor 1; hyprctl dispatch split-movetoworkspace 2
bindd = SUPER SHIFT, code:16, Move win to WS 7, exec, hyprctl dispatch movewindow mon:1; hyprctl dispatch focusmonitor 1; hyprctl dispatch split-movetoworkspace 3
bindd = SUPER SHIFT, code:17, Move win to WS 8, exec, hyprctl dispatch movewindow mon:1; hyprctl dispatch focusmonitor 1; hyprctl dispatch split-movetoworkspace 4

# Cycle workspaces on current monitor
bindd = SUPER, TAB, Cycle WS next, split-cycleworkspaces, next
bindd = SUPER SHIFT, TAB, Cycle WS prev, split-cycleworkspaces, prev

# SUPER + SHIFT + LEFT/RIGHT = send window to prev/next monitor
bindd = SUPER CTRL SHIFT, LEFT, Send win to left mon, movewindow, mon:l
bindd = SUPER CTRL SHIFT, RIGHT, Send win to right mon, movewindow, mon:r

# Fix workspace cycling
unbind = SUPER, TAB
unbind = SUPER SHIFT, TAB

bind = SUPER, TAB, split-workspace, +1
bind = SUPER SHIFT, TAB, split-workspace, -1

waybar/config.jsonc

  "hyprland/workspaces": {
    "all-outputs": false,
    "sort-by-number": true,
    "disable-scroll": true,
    "on-click": "activate",
    "format": "{icon}",
  },

waybar/style.css

#workspaces button {
  all: initial;
  padding: 0 6px;
  margin: 0 1.5px;
  min-width: 9px;
  opacity: 0.5;
}

#workspaces button.visible,
#workspaces button.active {
  font-weight: bold;
  opacity: 1;
}

[brombirium]

Thank you to OP and @opajanvv, this is exactly what I needed. New to omarchy / hyprland and the default dual monitor setup confused me beyond believe. :D

[opajanvv]

Thanks.
I’m gathering all my experiences with Omarchy in a blog, mainly for my own reference, so I can see why I made certain decisions. But of course, others can also use it to get ideas for their own configuration. It’s not complete yet, so feel free to check back from time to time to see if I’ve published a new blog post.
See https://opa.janvv.nl/tag:omarchy.