KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

libnvc

★ 40 Open GitHub ↗

Easy way to embed (neo)vim in your application

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# libnvc

I realize nvim now provides ```libnvim.a```, this repo may not be needed anymore.

another c++-20 nvim msgpack-rpc client, nvim-0.5.0 tested.  
nvim's rpc interface is convenient but not something you can finish in 10 minutes.  
this repo creates libnvc.a and you can use it to read/write a process running neovim easily.

![image](https://github.com/etorth/libnvc/raw/master/readme/cap.gif)

start nvim and use ```asio_socket``` to talk to it:

```cpp
#include "libnvc.hpp"

int main()
{
    // start nvim:
    // $ nvim --listen "127.0.0.1:6666"
    libnvc::asio_socket socket;
    if(!socket.connect("localhost", 6666)){
        throw std::runtime_error("failed to connect to localhost:6666");
    }

libnvc::api_client client(&socket);
    client.nvim_input("$i123<CR>123<ESC>");
    client.nvim_buf_set_name(1, "1234");
```
or use ```reproc_device``` to spawn a process running nvim in background:

```cpp
#include "libnvc.hpp"

int main()
{
    // spawn nvim process with default parameters
    libnvc::reproc_device reproc_dev;
    reproc_dev.spawn();

libnvc::api_client client(&reproc_dev);
    client.nvim_ui_attach(100, 80, {{"rgb", true}, {"ext_linegrid", true}});
    client.nvim_input("$i123<CR>123<ESC>");
    client.nvim_buf_set_name(1, "1234");
```

### build  
there is zero dependenct for user's building environment.  
libnvc use asio, mpack and reproc internally but hiden by pimpl.

```bash
# build the libnvc library, nvim should be in your PATH
$ cd $HOME
$ git clone https://github.com/etorth/libnvc.git
$ mkdir b_libnvc && cd b_libnvc
$ cmake ../libnvc -DCMAKE_INSTALL_PREFIX=install -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++
$ make && make install

# build the sample project, a simple nvim gui
# this requires SDL2, SDL2-image and SDL2-ttf installed
$ cd $HOME
$ mkdir b_nvim_sdl2 && cd b_nvim_sdl2
$ cmake ../libnvc/sample/nvim_sdl2 -DCMAKE_INSTALL_PREFIX=install -DLIBNVC_INCLUDE=$HOME/b_libnvc/install/include -DLIBNVC_LIB=$HOME/b_libnvc/install/lib
$ make && make install

# run the sample gui
$ cd $HOME/b_nvim_sdl2/install/nvim_sdl2 && ./nvim_sdl2
```

libnvc

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README