tmux-fuzzback

tmux-fuzzback uses fzf to search terminal scrollback buffer, and jump to selected position.

Attribution

This plugin would not be possible without the work done in copycat. Go download it, use it, and give it some love. I also drew more than a little inspiration from tmux-fzf-url. Huge thanks to both.

Requirements

• tmux version >= 2.4
• fzf

Installation

Using Tmux Plugin Manager (recommended)

set -g @plugin 'roosta/tmux-fuzzback'

Manually

git clone https://github.com/roosta/tmux-fuzzback

Add this to the bottom of .tmux.conf

run-shell ~/path/to/repo/fuzzback.tmux

Reload TMUX env

tmux source-file ~/.tmux.conf

Usage

To use tmux-fuzzback, start it in a tmux session by typing prefix + ?. Now you can start fuzzy searching in your scrollback buffer using fzf.

Options

Key binding

The default key-binding is ? preceded by a prefix, it can be modified by setting value to @fuzzback-bind in the tmux config like this:

set -g @fuzzback-bind s

Make sure this setting is set before loading the plugin.

Enable popup

You can enable tmux popup by setting this variable in your tmux conf. Keep in mind that only recent versions 3.2 and above of tmux support this.

set -g @fuzzback-popup 1

Popup size

You can set the popup size with this option.

set -g @fuzzback-popup-size '90%'

fzf layout

You can reverse the direction of fzf by setting this variable. The default is default

set -g @fuzzback-fzf-layout 'reverse'

fzf bind

If you want to bind some keybinding using fzf --bind that's only used in fuzzback set this variable.

set -g @fuzzback-fzf-bind 'ctrl-y:execute-silent(echo -n {3..} | xsel -ib)+abort'

This will copy the line matches in fzf to the clipboard if xsel is available.

Refer to fzf documentation for more details.

Keybind table

Normally the fuzzback keybind will go into the prefix table, but if you want to activate fuzzback without typing the prefix, you can change the table here. Say you wanted to activate fuzzback without prefix:

# this is the same as bind-key -n
set -g @fuzzback-table 'root'

Make sure this option, same as keybind, is set before loading the plugin.

Limitations

Column movement

Depending on the complexity of the search query, fuzzback might not know what column to move to, and will place you at the start of the line unless a literal match can be found.

Developing

You can run tests locally using Vagrant by calling:

# cd project root
./run_tests

License

MIT