Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/TheSast/tmux-nav-master
Easy cross-navigation between tmux and other terminal applications.
https://github.com/TheSast/tmux-nav-master
navig shell tmux tmux-plugin tmux-plugins tpm
Last synced: 3 months ago
JSON representation
Easy cross-navigation between tmux and other terminal applications.
- Host: GitHub
- URL: https://github.com/TheSast/tmux-nav-master
- Owner: TheSast
- License: other
- Created: 2023-05-09T17:47:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-01T18:14:08.000Z (6 months ago)
- Last Synced: 2024-05-02T12:46:42.714Z (6 months ago)
- Topics: navig, shell, tmux, tmux-plugin, tmux-plugins, tpm
- Language: Shell
- Homepage:
- Size: 662 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-tmux - tmux-nav-master - navigation between tmux and other terminal applications. (<a name="tools"></a>Tools and session management)
README
Tmux Nav Master
================
This plugin is *currently* an extended version of [vim-tmux-navigator](https://github.com/christoomey/vim-tmux-navigator) made to complement [Astronvim's default keybindings](https://github.com/AstroNvim/astronvim.github.io/blob/37bbb0894b623eea49000b290b4ce645a97cc47e/docs/Basic%20Usage/mappings.md#general-mappings).
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!
Preview
-------
Usage
-----
This plugin provides the following mappings in both "default" and "copy-mode-vi" modes
Mapping | Action |
--------------- | ----------------------- |
`` | Go Left |
`` | Go Down |
`` | Go Up |
`` | Go Right |
`` | Send an escaped `` |
`` | Send an escaped `` |
`` | Send an escaped `` |
`` | Send an escaped `` |
`H` | Swap Left |
`J` | Swap Down |
`K` | Swap Up |
`L` | Swap Right |
`` | Resize Left |
`` | Resize Down |
`` | Resize Up |
`` | Resize Right |
These mapping are setup to work intuitively with some software (e.g. [nvim](https://github.com/neovim/neovim), [fzf](https://github.com/junegunn/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](https://github.com/TheSast/tmux-nav-master/issues/new).
Installation
------------
1. You can use [TPM](https://github.com/tmux-plugins/tpm) to install this plugin.
2. Add the following line to your `tmux.conf`:
``` tmux
set -g @plugin 'TheSast/tmux-nav-master'
```
3. Install the plugin with I, unless you changed `@tpm-install`, in which case you need to use the keybind you set.
Other plugins
-------------
You might also like these plugins:
- [tmux-transient-status](https://github.com/TheSast/tmux-transient-status) - Automatically make your tmux status bar vanish when unneded.
- [tmux-keylocker](https://github.com/TheSast/tmux-keylocker) - Lock away your tmux keybinds temporarely.
Licence
-------
[MIT and Apache 2.0](COPYRIGHT.md)