https://github.com/d-e-s-o/neovim-ctrl
A program for controlling a Neovim instance, typically from a tmux environment.
https://github.com/d-e-s-o/neovim-ctrl
linux neovim rust tmux
Last synced: 4 months ago
JSON representation
A program for controlling a Neovim instance, typically from a tmux environment.
- Host: GitHub
- URL: https://github.com/d-e-s-o/neovim-ctrl
- Owner: d-e-s-o
- License: gpl-3.0
- Created: 2019-02-05T06:53:00.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-10-06T15:34:28.000Z (9 months ago)
- Last Synced: 2025-03-16T15:54:08.333Z (4 months ago)
- Topics: linux, neovim, rust, tmux
- Language: Rust
- Homepage:
- Size: 96.7 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/d-e-s-o/neovim-ctrl/actions/workflows/test.yml)
[](https://crates.io/crates/neovim-ctrl)
[](https://blog.rust-lang.org/2021/12/02/Rust-1.57.0.html)
neovim-ctrl
===========
- [Changelog](CHANGELOG.md)
**neovim-ctrl** is a program to find and interact with a Neovim instance
running in a particular terminal. It works with Neovim 0.9.0 and higher.
The program supports two commands:
- `find-socket` to discover the Unix domain socket of a running Neovim
- `change-window` to change the currently selected window/split based on
a key sequence
Usage
-----
The program requires the TTY for which to find the (first) running
Neovim process the first argument.
```bash
# Find the path to the Unix domain socket for a nvim process on TTY
# /dev/pts/3:
$ nvim-ctrl find-socket /dev/pts/3
> /tmp/nvimfMfu99/0
```
```bash
# Send Ctrl-w-h to the Neovim on /dev/pts/7:
$ ctrlw=$(echo -n -e "\\x17")
$ nvim-ctrl change-window /dev/pts/7 "${ctrlw}h"
# Exit code 0 indicates that the window was actually changed.
$ echo $?
> 0
$ nvim-ctrl change-window /dev/pts/7 "${ctrlw}h"
> Error: nothing changed
# Exit code 1 means that no change happened.
$ echo $?
> 1
```