global = default keybind layer

[streetcandies]

After much meditation on the word global in line 6 of hyprland.conf, I came to the conclusion to use global, not reset, when exiting a submap. global returns you to the default keybind layer.

Correct:
bind = ALT, P, submap, resize

submap = resize
binde = , right, resizeactive, 10 0
binde = , left, resizeactive,-10 0
binde = , up, resizeactive, 0 -10
binde = , down, resizeactive, 0 10
bind = , escape, submap, global
submap = global

Wrong:
bind = ALT, P, submap, resize

submap = resize
binde = , right, resizeactive, 10 0
binde = , left, resizeactive,-10 0
binde = , up, resizeactive, 0 -10
binde = , down, resizeactive, 0 10
bind = , escape, submap, reset
submap = reset

Is that right?

[end-4]

Yes
Note that global isn't any special submap, it's just a name. We need everything to be in a submap to use catchall, which allows declaring the keybinds in a way that makes the "hold super to show workspace numbers" more responsive

[chewwallwa]

bro, wth... I took 2 days on it :) I almost oppened a new discusison, but it was there and in 1 min solved my 2 day problem ?)

[streetcandies]

You can also add visual feedback to submaps by changing the active border color. I picked this up from a Reddit post by u/Economy_Cabinet_7719 and extended it across window, mouse, VM, and Emacs-driven workflows.Each mode enters a submap, updates the border color, and restores defaults on exit. Nested submaps are supported (e.g., resize → move → center). Note, these binds could probably be cleaned up and optimized better.

;These are aliases for active/inactive border colors

general {
col.active_border = rgba(F7DCDE39)
col.inactive_border = rgba(A58A8D30)
}

;Basic Submaps

bind = ALT, R, exec, hyprctl keyword general:col.active_border "$border_colorize" && hyprctl dispatch submap resize
submap = resize
binde = , h, resizeactive, -20 0
binde = , l, resizeactive, 20 0
binde = , j, resizeactive, 0 20
binde = , k, resizeactive, 0 -20
bind = , m, submap, move
bind = , c, submap, center
bind = , escape, exec, hyprctl keyword general:col.active_border "$border_normal" && hyprctl dispatch submap global
submap = global

submap = move
binde = , h, moveactive, -20 0
binde = , l, moveactive, 20 0
binde = , j, moveactive, 0 20
binde = , k, moveactive, 0 -20
bind = SHIFT, H, movewindow, l
bind = SHIFT, L, movewindow, r
bind = SHIFT, K, movewindow, u
bind = SHIFT, J, movewindow, d
bind = , c, centerwindow
bind = , r, submap, resize
bind = , escape, exec, hyprctl keyword general:col.active_border "$border_normal" && hyprctl dispatch submap global
submap = global

submap = center
bind = , c, centerwindow
bind = , r, submap, resize
bind = , escape, exec, hyprctl keyword general:col.active_border "$border_normal" && hyprctl dispatch submap global
submap = global

bind = ALT, G, exec, hyprctl keyword general:col.active_border "$border_colorize" && hyprctl dispatch submap mousemode
submap = mousemode
binde = , H, exec, ydotool mousemove -x -20 -y 0
binde = , L, exec, ydotool mousemove -x 20 -y 0
binde = , K, exec, ydotool mousemove -x 0 -y -20
binde = , J, exec, ydotool mousemove -x 0 -y 20
bind = , G, exec, ydotool click 0xC0
bind = , R, exec, ydotool click 0xC1
bind = , C, exec, ydotool click -r 3 0xC0 && sleep 0.05 && ydotool key 29:1 46:1 46:0 29:0
bind = , escape, exec, hyprctl keyword general:col.active_border "$border_normal" && hyprctl dispatch submap global
submap = global

bind = ALT, M, exec, hyprctl keyword general:col.active_border "rgba(ff0000ee)" && hyprctl dispatch submap virtual-machine
submap = virtual-machine
bind = ALT, M, exec, hyprctl keyword general:col.active_border "$border_normal" && hyprctl dispatch submap global
submap = global

; Emacs Submap (auto closes after bind execution)

; Enter Emacs submap + tint border (single hyprctl call)
bind = $mainMod, E, exec, hyprctl --batch "keyword general:col.active_border rgba(98fb98ff); dispatch submap emacs"

submap = emacs, global

bind = , S, exec, bash -lc 'emacs >/dev/null 2>&1 & disown' && hyprctl keyword general:col.active_border "$border_normal"

; desc: New vterm frame (main terminal)
bind = , V, exec, emacsclient -n -e '(my/new-frame-with-vterm)' && hyprctl keyword general:col.active_border "$border_normal"

; desc: vterm-at-point inside project
bind = , Return, exec, $HOME/bin/emacs-launcher '(my-open-vterm-at-point)' && hyprctl keyword general:col.active_border "$border_normal"

; desc: Universal Launcher popup (replaces wofi/rofi)
bind = , Space, exec, $HOME/bin/emacs-launcher '(progn (select-frame-set-input-focus (selected-frame)) (universal-launcher-popup))' && hyprctl keyword general:col.active_border "$border_normal"

; desc: Instant org-capture
bind = , C, exec, $HOME/bin/emacs-launcher '(progn (select-frame-set-input-focus (selected-frame)) (org-capture))' && hyprctl keyword general:col.active_border "$border_normal"

; desc: Open notes.org
bind = , N, exec, $HOME/bin/emacs-launcher '(progn (select-frame-set-input-focus (selected-frame)) (find-file "'"$HOME"'/org/notes.org"))' && hyprctl keyword general:col.active_border "$border_normal"

; desc: Open linux_commands.org
bind = , L, exec, $HOME/bin/emacs-launcher '(progn (select-frame-set-input-focus (selected-frame)) (find-file "'"$HOME"'/org/linux_commands.org"))' && hyprctl keyword general:col.active_border "$border_normal"

; desc: Org agenda dashboard
bind = , A, exec, $HOME/bin/emacs-launcher '(progn (select-frame-set-input-focus (selected-frame)) (my/org-agenda-dashboard))' && hyprctl keyword general:col.active_border "$border_normal"

; desc: Password manager (pass)
bind = , P, exec, $HOME/bin/emacs-launcher '(progn (select-frame-set-input-focus (selected-frame)) (pass))' && hyprctl keyword general:col.active_border "$border_normal"

; desc: Dirvish file browser
bind = , F, exec, $HOME/bin/emacs-launcher '(progn (select-frame-set-input-focus (selected-frame)) (dirvish))' && hyprctl keyword general:col.active_border "$border_normal"

; desc: Bookmarks file
bind = , B, exec, $HOME/bin/emacs-launcher '(progn (select-frame-set-input-focus (selected-frame)) (find-file "~/org/bookmarks.org"))' && hyprctl keyword general:col.active_border "$border_normal"

; desc: RSS reader (elfeed)
bind = CTRL, Z, exec, $HOME/bin/emacs-launcher '(progn (select-frame-set-input-focus (selected-frame)) (elfeed))' && hyprctl keyword general:col.active_border "$border_normal"

; desc: Emacs-everywhere (edit browser text)
bind = , T, exec, emacsclient --eval '(thanos/type)' && hyprctl keyword general:col.active_border "$border_normal"

bind = , escape, exec, hyprctl keyword general:col.active_border "$border_normal"

submap = global

[chewwallwa]

#2742 I've made a popup/visual to show the submaps:) thx