https://github.com/tshirtman/vim-winny

Swap and Jump to windows easily
https://github.com/tshirtman/vim-winny

Last synced: 17 days ago
JSON representation

Swap and Jump to windows easily

• Host: GitHub
• URL: https://github.com/tshirtman/vim-winny
• Owner: tshirtman
• Created: 2023-06-19T12:04:26.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-10-09T13:15:11.000Z (about 1 year ago)
• Last Synced: 2024-10-27T07:23:50.275Z (about 2 months ago)
• Language: Vim Script
• Size: 7.81 KB
• Stars: 4
• Watchers: 1
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md

Awesome Lists containing this project

README

        
## Vim-winny

Help manage having more than a couple windows in vim.

Ever wished you could just swap two vim windows without having to reorganize

your full layout?

Ever did a sequence of l  etc, to move to a window half a screen

away? Sure, you can easily come back with p after, but it's easy to mess

with and have to walk over the place again. Yes you can type a number then 

but vim doesn't display window numbers by default, and it doesn't behave the

same in all situatinos.

Vim-winny is meant to simplify these cases, and possibly others in the future.

First, it allows you to display the windows ids temporarily using popups, using

the `ShowWindowNumbers` function.

It then builds on this function to provide two commonly useful ones.

JumpWindow(as_letters=v:null) will display the window numbers and wait for you

to hit a number key, then jump the focus to that window. If as_letters is

passed a different value from v:null, then instead of using the window id,

letters are used, allowing to target up to 52 different windows (lowercase then

uppercase).

SwapWindows([n], as_letters=v:null) will behave similaily but will swap the

buffers between the current window and the one you type the number of. It

accepts an optional parameter, if passed, it will directly swap the current

buffer with the one of the window with the passed id. Similarily to JumpWindow,

the second parameter allows using letters instead of numbers, to only pass the

second paramater, the first one can be passed the default v:null value.

### Mappings

No mappings are created by default, but you can use the following suggested

ones, or your own, to call the functions.

```vim

nnoremap   WinnyJumpWindowLetter

nnoremap m WinnySwapWindowsLetter

nnoremap  t WinnyShowWindows

" these ones are needed for it to work in :term

tnoremap  WinnyJumpWindowLetter

tnoremap m WinnySwapWindowsLetter

```

or if you prefer numbers to letters

```vim

nnoremap   WinnyJumpWindow

nnoremap  m WinnySwapWindows

nnoremap  t WinnyShowWindows

```

### contribution

If you see similarily useful fonctions to manage windows more efficiently, feel

free to sugesest them, no promise on what's going to be accepted, but I'll

certainly consider them.

### Misc

ChatGPT was used to generate the initial version of the nmbers/letters ascii

art, but they were touched up to suit the taste of the author a bit better.

Contribution on making them more consistent and legible are also welcome.

### License

vim-winny is licensed under the MIT license