buffer_manager.nvim

<div align="center">

![bm_logo_simple](https://github.com/user-attachments/assets/5bb65a2a-358f-4c3f-a776-93df0242ccba)

### A simple plugin to easily manage Neovim buffers

[![Neovim](https://img.shields.io/badge/Neovim%200.5+-green.svg?style=for-the-badge&logo=neovim)](https://neovim.io)
[![Lua](https://img.shields.io/badge/Lua-blue.svg?style=for-the-badge&logo=lua)](http://www.lua.org)

https://user-images.githubusercontent.com/48717183/205488331-fbd939bf-d8e2-42bf-bea5-8956e2e02f51.mp4

</div>


## The never-ending problem

I want to manage Neovim buffers easily, without the mental overhead of remembering its ids or partial names. Buffer management includes moving to a buffer and deleting/adding one or more buffers.

## The proposed solution

Use a buffer-like floating window where all the open buffers are listed. To select one buffer, just hit its line identifier (a char), or move to it and press `<CR>`. To delete the buffer, delete it from the list. To add it (predictably) add a filename to the list.


## Installation

* Neovim 0.5.0+ required
* Install `buffer_manager` using your favorite plugin manager. E.g. `Packer.nvim`:

```lua
use 'nvim-lua/plenary.nvim'  -- basic dependency
use 'j-morano/buffer_manager.nvim'
```

## Usage

### View all buffers and go to a buffer

```lua
:lua require("buffer_manager.ui").toggle_quick_menu()
```

Then, move to one of them, and open it with `<CR>`.
Alternative: press the key corresponding to its line identifier char, which are numbers by default (notice that, in this case, 0 maps to 10, since there is no 0 line).

### Add buffer/Create file

Write the filename of the new buffer.

(Some people will find this useless, but I often use this functionality together with an autocomplete for files.)

Tip: you can use the Neovim built-in file autocomplete functionality (`<C-x><C-f>`) to ease the opening of new files.

If the file does not exist, a new empty buffer will be created, which will be written to the specified file when it is saved.

### Remove buffer

Delete it in the buffer menu.

**Note:** the plugin does not remove terminal buffers or modified buffers.

### Reorganize buffers

The buffers can be reorganized in any way. To do it, just move the name of the buffer to the chosen line.

### Go to next or previous buffer in the list

```lua
:lua require("buffer_manager.ui").nav_next()
:lua require("buffer_manager.ui").nav_prev()
```

### Save buffer list to a file or load it

Introduce the filename interactively:
```lua
:lua require'buffer_manager.ui'.save_menu_to_file()
:lua require'buffer_manager.ui'.load_menu_from_file()
```

Introduce the filename directly as a function argument:
```lua
:lua require'buffer_manager.ui'.save_menu_to_file('bm')
:lua require'buffer_manager.ui'.load_menu_from_file('bm')
```

## Configuration

### Plugin configuration

The plugin can be configured through the setup function:
```lua
require("buffer_manager").setup({ })
```

#### Available configuration options

* `select_me