global shortcuts

pages/Configuring/Binds.md

@@ -203,6 +203,7 @@ bindr=ALT,Alt_L,exec,amongus
 
 # Global Keybinds
 
+## Classic
 Yes, you heard this right, Hyprland does support global keybinds for ALL apps,
 including OBS, Discord, Firefox, etc.
 
@@ -239,6 +240,22 @@ they don't work, try removing mods and binding them to e.g. <key>F1</key>.
 Combining this with a submap should yield neat and usable results.
 {{< /hint >}}
 
+## DBus Global Shortcuts
+Some applications may already support the GlobalShortcuts portal in xdg-desktop-portal.
+
+If that's the case, then it's recommended to use this method instead of `pass`.
+
+Open your desired app and issue `hyprctl globalshortcuts`. This will give you a list
+of currently registered shortcuts with their description(s).
+
+Choose whichever you like, for example `coolApp:myToggle`
+
+Bind it to whatever you want with the `global` dispatcher:
+
+```
+bind = SUPERSHIFT, A, global, coolApp:myToggle
+```
+
 # Submaps
 
 If you want keybind submaps, also known as _modes_ or _groups_, for example if

pages/Configuring/Dispatchers.md

@@ -64,6 +64,7 @@ layout pages (See the sidebar).
 | lockgroups | Locks the groups (groups will not accept new windows) | `lock` for locking, `unlock` for unlocking, `toggle` for toggle |
 | moveintogroup | Moves the active window into a group in a specified direction. No-op if there is no group in the specified direction. | direction |
 | moveoutofgroup | Moves the active window out of a group. No-op if not in a group | none |
+| global | Executes a Global Shortcut using the GlobalShortcuts portal. See [here](../Binds/#global-keybinds) | name |
 
 {{< hint type=warning >}}
 it is NOT recommended to set DPMS with a keybind directly, as it