Omahub
← All plugins
G

Submap

by GeertJohan

Active Hyprland submap indicator

Install
$ omarchy plugin add https://github.com/GeertJohan/omarchy-submap-widget --enable
Widgets #Hyprland #bar #quickshell

omarchy-submap-widget

An Omarchy shell bar widget that shows which Hyprland submap you are in, and nothing at all when you aren't in one.

The bar showing the resize submap

If you use submaps (resize mode, launch mode, a vim-style leader key, ...) there is normally no feedback that one is active: keys just stop doing what they usually do. This widget puts the submap's name in the bar, in the bar's urgent accent color, for exactly as long as the submap is active.

Install

omarchy plugin add https://github.com/GeertJohan/omarchy-submap-widget.git --enable

Pick a bar section when prompted (it defaults to left, next to the workspaces). You can move it later with:

omarchy bar move geertjohan.submap --section center

Uninstall

omarchy plugin remove geertjohan.submap

How it works

The widget listens for Hyprland's submap IPC event, so it needs no polling and reacts instantly. On shell start it asks hyprctl submap once, so a shell restart while a submap is active still shows the right state. Outside a submap the widget is fully hidden and takes no bar space.

Requirements

Omarchy with the Quickshell-based shell (Omarchy 4.0 "quattro" or later).

License

MIT