Table of Contents

Keybinds

The keybinds configuration has a list of bindings that you can use to bind commands to key combinations.

Bindings

A key modifier is a key that is pressed in combination with another key to perform a specific action. The bindings property is a list of keybinds that map a command to a key combination.

The format of a keybind is Mod1+Mod2+...+Key, where Mod1, Mod2, etc. are key modifiers and Key is the key that is pressed in combination with the modifiers.

Key modifiers are typically one of the following:

  • Ctrl
  • Control
  • LCtrl
  • LControl
  • RCtrl
  • RControl
  • Shift
  • LShift
  • RShift
  • Alt
  • LAlt
  • RAlt
  • Win
  • LWin
  • RWin

Keybinds can also be any other key, though it's recommended to use keys which aren't typically used for other purposes.

The associated key for each modifier can be any of the VIRTUAL_KEYs, without the VK* prefix.

Commands

A command is a string that represents a command that can be executed by Whim. The command can be a built-in command, a plugin command, or a custom command. For more, see the Commands page.

Unify Key Modifiers

To treat key modifiers like LWin and RWin the same, set unify_key_modifiers to true.

Keybinds Example

keybinds:
  entries:
    - command: whim.core.focus_next_monitor
      keybind: LCtrl+LShift+LAlt+K

    - command: whim.core.focus_previous_monitor
      keybind: LCtrl+LShift+LAlt+J

    - command: whim.custom.next_layout_engine
      keybind: LCtrl+LShift+LAlt+L

    - command: whim.core.cycle_layout_engine.next
      keybind: LCtrl+LShift+LAlt+L

    - command: whim.core.cycle_layout_engine.previous
      keybind: LCtrl+LShift+LAlt+Win+L

    - command: whim.command_palette.find_focus_window
      keybind: Win+LCtrl+F

    - command: whim.core.exit_whim
      keybind: Win+LCtrl+Q

  unify_key_modifiers: true