https://github.com/nyngwang/NeoTerm.lua

You can attach a terminal-buffer for each buffer.
https://github.com/nyngwang/NeoTerm.lua

lua neovim neovim-plugin

Last synced: about 2 months ago
JSON representation

You can attach a terminal-buffer for each buffer.

• Host: GitHub
• URL: https://github.com/nyngwang/NeoTerm.lua
• Owner: nyngwang
• License: mit
• Created: 2022-06-19T23:05:06.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-27T09:01:32.000Z (8 months ago)
• Last Synced: 2024-04-12T12:06:04.415Z (5 months ago)
• Topics: lua, neovim, neovim-plugin
• Language: Lua
• Homepage:
• Size: 47.9 KB
• Stars: 67
• Watchers: 2
• Forks: 4
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-neovim - nyngwang/NeoTerm.lua - Attach a terminal for each **buffer**, now with stable toggle and astonishing cursor restoring. (Terminal Integration / CSV Files)

README

        


NeoTerm.lua

-----

Now you have two sides for each **buffer**:

1. The buffer itself

2. Its terminal buffer.

and you just use one single command `NeoTermToggle` to switch the side of each one :)

## DEMO

https://user-images.githubusercontent.com/24765272/224787066-a51f18d3-3da7-440d-ab77-349a59aac050.mov

## Feat.

- ~0ms load time (lines ~200)

- No dependency.

- Only add two commands in your pocket: easy to remember.

- Focus on DX:

  - simple `setup`, so always readable.

  - auto enter insert-mode on `BufEnter` the terminal.

  - customizable(`term_mode_hl`) background color on enter termbuf insert-mode. :art:

### Feat.

- support [`vim-test/vim-test`](https://github.com/vim-test/vim-test) out-of-the-box (`setup.presets`).

## Config

```lua

use {

  'nyngwang/NeoTerm.lua',

  config = function ()

    require('neo-term').setup {

      exclude_filetypes = { 'oil' },

      -- exclude_buftypes = {}, -- 'terminal' will always be added by NeoTerm.lua

      -- enabled by default!

      -- presets = {

      --   'vim-test',

      -- }

    }

    vim.keymap.set('n', '', function () vim.cmd('NeoTermToggle') end)

    vim.keymap.set('t', '', function () vim.cmd('NeoTermEnterNormal') end)

  end

}

```