btterm

btterm stands for "Better Terminal". It aims to enhance the Neovim terminal experience, allowing easy bindings and autoinsert when moving to a terminal buffer.

⚡ Installation

Using folke/lazy.nvim:

return {
	"pvskp/btterm.nvim",
	lazy = false,
	config = function()
		require("btterm").setup({})
    	end,
}

🚀 Usage

By default, btterm will create the following mappings:

• <M-s>: Open a bottom terminal
• <M-d>: Open a side terminal

For better movement between windows, it's recommended to use a remap to deal with the terminal mode escape sequence (<C-\><C-N>, see :h terminal-input). For example:

--- Normal mode
vim.keymap.set("n", "<M-j>", "<C-w>j")
vim.keymap.set("n", "<M-k>", "<C-w>k")
vim.keymap.set("n", "<M-l>", "<C-w>l")
vim.keymap.set("n", "<M-h>", "<C-w>h")

--- Terminal mode
vim.keymap.set("t", "<M-k>", "<C-\\><C-n><C-w>k", { silent = true })
vim.keymap.set("t", "<M-j>", "<C-\\><C-n><C-w>j", { silent = true })
vim.keymap.set("t", "<M-l>", "<C-\\><C-n><C-w>l", { silent = true })
vim.keymap.set("t", "<M-h>", "<C-\\><C-n><C-w>h", { silent = true })

⚙️ Configuration

You can override the default mappings by passing a the following options to the setup function:

return {
	"pvskp/btterm.nvim",
	lazy = false,
	config = function()
		require("btterm").setup({
            bottom_term_key = "<M-s>",
            side_term_key = "<M-d>",
        })
    end,