f2e8742057 | ||
---|---|---|
.git-hooks | ||
docs | ||
scripts | ||
test | ||
vendor | ||
.gitignore | ||
.gitmodules | ||
CHANGELOG.md | ||
LICENSE | ||
README.md | ||
Vagrantfile | ||
circle.yml | ||
tmux-fingers.tmux | ||
tmuxomatic-test.sh |
README.md
tmux-fingers
tmux-fingers: copy pasting with vimium/vimperator like hints.
Usage
Press ( prefix + F
) to enter [fingers] mode, 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.
Key shortcuts
While in [fingers] mode, you can use the following shortcuts:
a-z
: yank a highlighted hint.<space>
: toggle compact hints ( see @fingers-compact-hints ).<Ctrl-C>
: exit [fingers] mode<esc>
: exit help or [fingers] mode?
: show help.
Requirements
- tmux 2.1+ ( 2.2 recommended )
- bash 4+
- gawk
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
default: F
Customize how to enter copy mode. Always preceded by prefix: prefix + @fingers-key
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'
Patterns are case insensitive, and grep's extended syntax ( ERE ) should be used.
man grep
for more info.
If the introduced regexp contains an error, an error will be shown when invoking the plugin.
It's recommended to install gawk
for better support of custom
patterns: some things like interval expressions do not work in built-in awk
in OSX/BSD systems.
@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'
@fingers-compact-hints
default: 1
By default tmux-fingers will show hints in a compact format. For example:
/path/to/foo/bar/lol with @fingers-compact-hints set to 1: awath/to/foo/bar/lol with @fingers-compact-hints set to 0: /path/to/foo/bar/lol [aw]
( pressing aw would yank /path/to/foo/bar/lol
)
While in [fingers] mode you can press <space>
to toggle compact mode on/off.
Compact mode is preferred because it preserves the length of lines and doesn't cause line wraps, making it easier to follow.
However for small hints this can be troublesome: a path as small as /a/b
would have half of its original content concealed. If that's the case you can
quickly toggle off compact mode by pressing <space>
.
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! 👏 👏