Skip to content

Latest commit

 

History

History
74 lines (48 loc) · 2.16 KB

README.md

File metadata and controls

74 lines (48 loc) · 2.16 KB

Tmux Sidebar

tmux-sidebar does one thing: it opens a tree directory listing for the current path. It's fast, convenient and works great with vim.

screenshot

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 main prefix + 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 tries hard not to mess your pane splits. Open, then close the sidebar and everything should look the same.

Requirements: tmux 1.9 or higher, tree recommended but not required

Tested and working on Linux, OSX and Cygwin.

Key bindings

  • prefix + Tab - toggle sidebar with a directory tree
  • prefix + 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 @plugin 'tmux-plugins/tmux-sidebar'

Hit prefix + I to fetch the plugin and source it. You should now be able to use the plugin.

Manual Installation

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.

Docs

Other goodies

  • tmux-copycat - a plugin for regex searches in tmux and fast match selection
  • tmux-resurrect - restore tmux environment after a system restart

License

MIT