This plugin is currently an extended version of vim-tmux-navigator made to complement Astronvim's default keybindings.
The goal is to eventually have a great, easy-to-set-up, largely non-intrusive plugin to help with navigation. For this very reason PRs are welcome!
This plugin provides the following mappings in both "default" and "copy-mode-vi" modes
Mapping | Action |
---|---|
<C-h> |
Go Left |
<C-j> |
Go Down |
<C-k> |
Go Up |
<C-l> |
Go Right |
<prefix><C-h> |
Send an escaped <C-h> |
<prefix><C-j> |
Send an escaped <C-j> |
<prefix><C-k> |
Send an escaped <C-k> |
<prefix><C-l> |
Send an escaped <C-l> |
<prefix>H |
Swap Left |
<prefix>J |
Swap Down |
<prefix>K |
Swap Up |
<prefix>L |
Swap Right |
<C-Left> |
Resize Left |
<C-Down> |
Resize Down |
<C-Up> |
Resize Up |
<C-Right> |
Resize Right |
These mapping are setup to work intuitively with some software (e.g. nvim, fzf) by being selectively disabled or by acting differently when needed. If you know of any others that might benefit from this behaviour please open an issue.
- You can use TPM to install this plugin.
- Add the following line to your
tmux.conf
:
set -g @plugin 'TheSast/tmux-nav-master'
- Install the plugin with I, unless you changed
@tpm-install
, in which case you need to use the keybind you set.
You might also like these plugins:
-
tmux-transient-status - Automatically make your tmux status bar vanish when unneded.
-
tmux-keylocker - Lock away your tmux keybinds temporarely.