Skip to content

Conversation

@JakePi3
Copy link

@JakePi3 JakePi3 commented Jan 6, 2026

Submaps

Submaps are a feature of hyprland where you enter an alternate mode that creates a new set of keybindings.

The keybindngs are associated with a corresponding submap name such as "remote" or "gamemode".

In this mode only newly defined keybinds are available while the default keybinds are disabled, until the user exits the submap and returns to the default keybinds.

Why is this Useful?

Some keybindings interfere with GUI/TUI apps because they capture and interpret the key combinations instead of forwarding them down to the underlying application. See discussion here.

Some keybindings may also interfere with gaming because combinations are too close to something that may terminate the application (consider ALT+W vs SUPER+W).

Why is this necessary?

Although it's possible to make use of submaps without modifying bin/omarchy-menu-keybindings, the existing operation will print keybindings across all submaps, including duplicates, even when some key combinations are not available within the context of the currently selected submap.

Example of Using a Submap

Easiest is to modify ~/.config/hypr/bindings.conf as in the linked discussion.

@JakePi3 JakePi3 changed the title Update omarchy-menu-keybindings to work with submaps feat: Update omarchy-menu-keybindings to work with submaps Jan 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant