Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dstein64/vim-win

A Vim plugin for managing windows.
https://github.com/dstein64/vim-win

neovim vim vim-plugin vim-window vim-windows

Last synced: about 1 month ago
JSON representation

A Vim plugin for managing windows.

Awesome Lists containing this project

README

        

[![build][badge_thumbnail]][badge_link]

# vim-win

`vim-win` is a Vim plugin for managing windows. Built-in functionality includes
window selection, window buffer swapping, and window resizing. The plugin is
extensible, allowing additional functionality to be added.

## Requirements

* Full functionality
- `vim>=8.2.4052` or `nvim>=0.7.0`

## Installation

A package manager can be used to install `vim-win`.
Examples

* [Vim8 packages][vim8pack]:
- `git clone https://github.com/dstein64/vim-win ~/.vim/pack/plugins/start/vim-win`
* [Vundle][vundle]:
- Add `Plugin 'dstein64/vim-win'` to `~/.vimrc`
- `:PluginInstall` or `$ vim +PluginInstall +qall`
* [Pathogen][pathogen]:
- `git clone --depth=1 https://github.com/dstein64/vim-win ~/.vim/bundle/vim-win`
* [vim-plug][vimplug]:
- Add `Plug 'dstein64/vim-win'` to `~/.vimrc`
- `:PlugInstall` or `$ vim +PlugInstall +qall`
* [dein.vim][dein]:
- Add `call dein#add('dstein64/vim-win')` to `~/.vimrc`
- `:call dein#install()`
* [NeoBundle][neobundle]:
- Add `NeoBundle 'dstein64/vim-win'` to `~/.vimrc`
- Re-open vim or execute `:source ~/.vimrc`

## Usage

Enter `vim-win` with `w` or `:Win`.

* Arrows or `hjkl` keys are used for movement.
* Change windows with movement keys or numbers.
* Hold `` and use movement keys to resize the active window.
* Press `s` or `S` followed by a movement key or window number, to swap buffers.
* Press `?` to show a help message.
* Press `` to leave `vim-win`.

See `:help win-usage` for additional details.

## Documentation

```vim
:help vim-win
```

The underlying markup is in [win.txt](doc/win.txt).

Demo

License
-------

The source code has an [MIT License](https://en.wikipedia.org/wiki/MIT_License).

See [LICENSE](LICENSE).

[badge_link]: https://github.com/dstein64/vim-win/actions/workflows/build.yml
[badge_thumbnail]: https://github.com/dstein64/vim-win/actions/workflows/build.yml/badge.svg
[dein]: https://github.com/Shougo/dein.vim
[neobundle]: https://github.com/Shougo/neobundle.vim
[pathogen]: https://github.com/tpope/vim-pathogen
[vim8pack]: http://vimhelp.appspot.com/repeat.txt.html#packages
[vimplug]: https://github.com/junegunn/vim-plug
[vundle]: https://github.com/gmarik/vundle