Go to file

Jorge Morante 36c0d1f9d7 /usr/bin/env bash all the things		2016-07-15 08:31:45 +02:00
.git-hooks	/usr/bin/env bash all the things	2016-07-15 08:31:45 +02:00
scripts	better rendering of wrapped lines	2016-07-14 22:47:16 +02:00
test	initial setup of automated tests	2016-07-14 22:48:01 +02:00
.gitignore	gitignore all logs	2016-07-14 22:45:14 +02:00
CHANGELOG.md	update CHANGELOG.md	2016-07-14 22:59:23 +02:00
LICENSE	README.md + LICENSE	2016-05-01 19:50:41 +02:00
README.md	initial setup of automated tests	2016-07-14 22:48:01 +02:00
Vagrantfile	initial setup of automated tests	2016-07-14 22:48:01 +02:00
circle.yml	initial setup of automated tests	2016-07-14 22:48:01 +02:00
tmux-fingers.tmux	user configurable patterns	2016-04-30 00:58:58 +02:00

README.md

tmux-fingers

tmux-fingers: copy pasting with vimium/vimperator like hints.

Usage

When called ( prefix + F ), it will highlight relevant stuff in the current pane along with letter hints. By pressing those letters, the highlighted match will be yanked. Less keystrokes == profit!

Relevant stuff:

File paths
git SHAs
numbers ( 4+ digits )
urls
ip addresses

It also works on copy mode, but requires tmux 2.2 or newer to properly take the scroll position into account.

Additionally, you can install tmux-yank for system clipboard integration.

Requirements

bash 4+
tmux 2.1+ ( 2.2 recommended )

Installation

Using Tmux Plugin Manager

Add the following to your list of TPM plugins in .tmux.conf:

set -g @plugin 'Morantron/tmux-fingers'

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

Manual

Clone the repo:

➜ git clone https://github.com/Morantron/tmux-fingers ~/clone/path

Source it in your .tmux.conf:

run-shell ~/clone/path/tmux-fingers.tmux

Reload TMUX conf by running:

➜ tmux source-file ~/.tmux.conf

Configuration

You can change the key that invokes tmux-fingers:

@fingers-key

F is the default key, but you can set another one.

set -g @fingers-key F

@fingers-patterns-N

You can also add additional patterns if you want more stuff to be highlighted:

set -g @fingers-pattern-0 'git rebase --(abort|continue)'
set -g @fingers-pattern-1 'yolo'
.
.
.
set -g @fingers-pattern-50 'whatever'

NOTE: patterns are case insensitive, and grep's extended syntax should be used. man grep for more info.

If the introduced regexp contains an error, an error will be shown when invoking the plugin.

@fingers-copy-command

By default tmux-fingers will just yank matches using tmux clipboard ( or tmux-yank if present ).

If you still want to set your own custom command you can do so like this:

set -g @fingers-copy-command 'xclip -selection clipboard'

Acknowledgements and inspiration

This plugin is heavily inspired by tmux-copycat ( tmux-fingers predefined search are copycatted :trollface: from tmux-copycat ).

Kudos to bruno- for paving the way to tmux plugins! 👏 👏

License

MIT