tmux-sidebar
does one thing: it opens a tree directory listing for the current
path. It's fast, convenient and works great with vim.
Some of the features that make the plugin more appealing than doing the same thing manually each time:
- fast
Much faster than doing each step manually. - smart sizing
Sidebar remembers its size, so the next time you open it, it will have the exact same width. This is a per-directory property, so you can have just the right size for multiple dirs. - toggling
The same key binding opens and closes the sidebar. - uninterrupted workflow
The mainprefix + Tab
key binding opens a sidebar but does not move cursor to it. - pane layout stays the same
No matter which pane layout you prefer, sidebar trys hard not to mess your pane splits. Open, then close the sidebar and everything should look the same.
Requirements: tmux 1.9
or higher
prefix + Tab
- toggle sidebar with a directory treeprefix + Backspace
- toggle sidebar and move cursor to it (focus it)
Installation with Tmux Plugin Manager (recommended)
Add plugin to the list of TPM plugins in .tmux.conf
:
set -g @tpm_plugins " \
tmux-plugins/tpm \
tmux-plugins/tmux-sidebar \
"
Hit prefix + I
to fetch the plugin and source it. You should now be able to
use the plugin.
Clone the repo:
$ git clone https://github.com/tmux-plugins/tmux-sidebar ~/clone/path
Add this line to the bottom of .tmux.conf
:
run-shell ~/clone/path/sidebar.tmux
Reload TMUX environment:
# type this in terminal
$ tmux source-file ~/.tmux.conf
You should now be able to use the plugin.
- tmux-copycat - a plugin for regex searches in tmux and fast match selection
- tmux-resurrect - restore tmux environment after a system restart