Neovim Terminal (nvim-terminal) Vim Plugin

This Vim plugin provides a floating terminal window that can be toggled on and off.

nvim-terminal.mp4

Installation

Use a plugin manager like vim-plug to install the plugin. Add the following to ~/.config/nvim/init.vim:

Plug 'Jantcu/nvim-terminal'

Then :PlugInstall

Usage

The default keyboard shortcuts are:

• Open/close small terminal: Alt-t
• Open/close large terminal: Alt-z
• Switch from terminal to main window: Ctrl-w+k
• Switch from main window to terminal: Ctrl-w+j
• Create new terminal when already in an opened terminal: Alt-+
• Rename current terminal: Alt-. (use Esc or Ctrl-c to cancel)
• Remove terminal when already in an opened terminal: Alt--
• Move to next terminal: Alt-]
• Move to previous terminal: Alt-[

Configuration defaults

You can override these in ~/.config/nvim/init.vim:

• let g:nvim_terminal_toggle_small = '<A-t>'
• let g:nvim_terminal_toggle_large = '<A-z>'
• let g:nvim_terminal_background_color = '#171b21'
• let g:nvim_terminal_statusline_color = '#3fbbce'
• let g:nvim_terminal_small_height = 10
• let g:nvim_terminal_large_height = 50

Contributing

Feel free to open issues if you have questions or run into problems, however, we likely won't be very responsive and may not fix issues. This is a project that fits the needs of our team and we just wanted to share it in case it was helpful to others in the current state that it's in. If you have bug fixes or feature requests, your best bet is to open a PR.

Similar projects

• https://github.com/akinsho/toggleterm.nvim
• https://github.com/rebelot/terminal.nvim