Question 1

How to install and set up WinShift.nvim in Neovim?

Accepted Answer

Install via a package manager like Packer or Plug, then configure with Lua in your init.lua using the provided setup function. The README includes examples for keymaps and options like enabling Win-Move mode.

Question 2

WinShift.nvim vs vim-tmux-navigator – which should I use?

Accepted Answer

WinShift.nvim is for advanced window rearrangement within Neovim, allowing free movement and swapping. Vim-tmux-navigator focuses on seamless navigation between Vim splits and tmux panes. Choose WinShift if you need to dynamically reorganize Neovim windows beyond basic swapping.

Question 3

Does WinShift.nvim work with floating windows or pop-ups?

Accepted Answer

Yes, but the window picker can filter out floating windows by default, and movement might handle them, though the README doesn't detail specific behavior for moving floating windows during Win-Move mode.

Question 4

What are the default keybindings for moving windows?

Accepted Answer

In Win-Move mode, default keys are hjkl and arrow keys for directional moves, with shift-modified keys (e.g., H, J) for far-end navigation. These can be customized or disabled in the configuration.

Question 5

How to quickly swap two windows with WinShift.nvim?

Accepted Answer

Use the :WinShift swap command to activate the window picker, then press the character displayed on the target window. The picker is configurable with filters to ignore certain window types like the current or floating windows.

Question 6

Can WinShift.nvim create new splits or only move existing ones?

Accepted Answer

It only moves existing windows, but moving a window horizontally or vertically can effectively form new columns or rows. Creating splits is still done with native Neovim commands like :split or :vsplit.

Question 7

Is WinShift.nvim compatible with Neovim nightly or older stable versions?

Accepted Answer

It requires Neovim ≥ 0.7.2, so it should work with newer versions including nightly, but compatibility isn't guaranteed for older versions like 0.6 or vanilla Vim, as stated in the Requirements.

winshift.nvim

What is winshift.nvim?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions