Skip to main content
Version: 1.2

Keybindings

See the keybind overview for most commonly used keybinds.

If you want to (re)map a keybinding that starts with <leader>, use Whichkey Bindings. If the bindings are LSP (intellisense) related, use LSP Bindings. In all other cases, use NeoVim mappings

Leader Keyโ€‹

The default leader key is Space. This can be changed with the following

lvim.leader = "space"

Listing what is mappedโ€‹

Use <Leader>Lk to view the keybindings set by Lunarvim.

To see if a particular key has already been bound:

:verbose map <TAB>
  • :nmap for normal mode mappings
  • :vmap for visual mode mappings
  • :imap for insert mode mappings

Or just list every mapping

:map

NeoVim mappingsโ€‹

(Re)mapping keysโ€‹

To modify or add a keymapping:

  -- X closes a buffer
lvim.keys.normal_mode["<S-x>"] = ":BufferKill<CR>"

-- Centers cursor when moving 1/2 page down
lvim.keys.normal_mode["<C-d>"] = "<C-d>zz"

Removing default mappingsโ€‹

To remove keymappings set by Lunarvim:

  lvim.keys.normal_mode["<C-h>"] = false
lvim.keys.normal_mode["<C-j>"] = false
lvim.keys.normal_mode["<C-k>"] = false
lvim.keys.normal_mode["<C-l>"] = false

LSP Bindingsโ€‹

To modify your LSP keybindings use lvim.lsp.buffer_mappings.[normal|visual|insert]_mode.

(Re)map a keyโ€‹

Map your own functionality

lvim.lsp.buffer_mappings.normal_mode['H'] = { vim.lsp.buf.hover, "Show documentation" }

Or map default functionality to a different key

lvim.lsp.buffer_mappings.normal_mode['gk'] = lvim.lsp.buffer_mappings.normal_mode['K']

Remove a bindingโ€‹

LSP bindings take precedence over regular keybindings. So in order to use a key for a regular binding, we have to remove it first

lvim.lsp.buffer_mappings.normal_mode['K'] = nil
lvim.keys.normal_mode['K'] = "<Cmd>echo Okay!<CR>"

Whichkey Bindingsโ€‹

To add or remap keybindings for whichkey use lvim.builtin.which_key.mappings. The leader key is already included.

Single mappingโ€‹

Map a single key.

lvim.builtin.which_key.mappings["P"] = {
"<cmd>lua require'telescope'.extensions.project.project{}<CR>", "Projects"
}

As stated above, the leader key is included. So for the above example, the keybinding becomes <leader>P

Removing a single mappingโ€‹

Remove a single Whichkey keybind

lvim.builtin.which_key.mappings['w'] = {}

Adding a key to an existing menu/submenu.

lvim.builtin.which_key.mappings["tP"] = {
"<cmd>lua require'telescope'.extensions.project.project{}<CR>", "Projects"
}

Map a group of keys. Definitions would be triggered by pressing <Leader>td. The name for this menu would appear as Trouble.

lvim.builtin.which_key.mappings["t"] = {
name = "Trouble",
r = { "<cmd>Trouble lsp_references<cr>", "References" },
f = { "<cmd>Trouble lsp_definitions<cr>", "Definitions" },
d = { "<cmd>Trouble lsp_document_diagnostics<cr>", "Diagnostics" },
q = { "<cmd>Trouble quickfix<cr>", "QuickFix" },
l = { "<cmd>Trouble loclist<cr>", "LocationList" },
w = { "<cmd>Trouble lsp_workspace_diagnostics<cr>", "Diagnostics" },
}

Replace all whichkey mappingsโ€‹

To clear all whichkey bindings and replace all mappings with your own, use this form.

lvim.builtin.which_key.mappings = {
["c"] = { "<cmd>BufferClose!<CR>", "Close Buffer" },
["e"] = { "<cmd>NvimTreeToggle<CR>", "Explorer" },
["h"] = { '<cmd>let @/=""<CR>', "No Highlight" },

p = {
name = "Packer",
c = { "<cmd>PackerCompile<cr>", "Compile" },
i = { "<cmd>PackerInstall<cr>", "Install" },
r = { "<cmd>LvimReload<cr>", "Reload" },
s = { "<cmd>PackerSync<cr>", "Sync" },
u = { "<cmd>PackerUpdate<cr>", "Update" },
},
}

toggleterm (terminal) mappingsโ€‹

To change the terminal mapping:

lvim.builtin.terminal.open_mapping = "<c-t>"