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 copied to the clipboard. Less keystrokes == profit!
Here is a list of the stuff highlighted by default.
- File paths
- SHAs
- numbers ( 4+ digits )
- hex numbers
- IP addresses
- kubernetes resources
- UUIDs
- git status/diff output
Checkout list of built-in patterns.
While in [fingers] mode, you can use the following shortcuts:
- a-z: copies selected match to the clipboard
- CTRL + a-z: copies selected match to the clipboard and triggers @fingers-ctrl-action. By default it triggers
:open:
action, which is useful for opening links in the browser for example. - SHIFT + a-z: copies selected match to the clipboard and triggers @fingers-shift-action. By default it triggers
:paste:
action, which automatically pastes selected matches. - ALT + a-z: copies selected match to the clipboard and triggers @fingers-alt-action. There is no default, configurable by the user.
- TAB: toggle multi mode. First press enters multi mode, which allows to select multiple matches. Second press will exit with the selected matches copied to the clipboard.
- q, ESC or CTRL + c: exit [fingers] mode
- tmux 3.0 or newer
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. The first time you run it you'll be presented with a wizard to complete the installation.
Clone the repo:
$ git clone https://github.com/Morantron/tmux-fingers ~/.tmux/plugins/tmux-fingers
Source it in your .tmux.conf
:
run-shell ~/.tmux/plugins/tmux-fingers/tmux-fingers.tmux
Reload TMUX conf by running:
$ tmux source-file ~/.tmux.conf
The first time you run it you'll be presented with a wizard to complete the installation.
NOTE: for changes to take effect, you'll need to source again your .tmux.conf
file.
- @fingers-key
- @fingers-jump-key
- @fingers-patterns-N
- @fingers-main-action
- @fingers-ctrl-action
- @fingers-alt-action
- @fingers-shift-action
- @fingers-hint-style
- @fingers-highlight-style
- @fingers-backdrop-style
- @fingers-selected-hint-style
- @fingers-selected-highlight-style
- @fingers-hint-position
- @fingers-keyboard-layout
- @fingers-show-copied-notification
- @fingers-enabled-builtin-patterns
Recipes:
default: F
Customize how to enter fingers mode. Always preceded by prefix: prefix + @fingers-key
.
For example:
set -g @fingers-key F
default: J
Customize how to enter fingers jump mode. Always preceded by prefix: prefix + @fingers-jump-key
.
In jump mode, the cursor will be placed in the position of the match after the hint is selected.
You can also add additional patterns if you want more stuff to be highlighted:
# You can define custom patterns like this
set -g @fingers-pattern-0 'git rebase --(abort|continue)'
# Increment the number and define more patterns
set -g @fingers-pattern-1 'some other pattern'
# You can use a named capture group like this (?<match>YOUR-REGEX-HERE)
# to only highlight and copy part of the match.
set -g @fingers-pattern-2 'capture (?<match>only this)'
# Watch out for backslashes! For example the regex \d{50} matches 50 digits.
set -g @fingers-pattern-3 '\d{50}' # No need to escape if you use single quotes
set -g @fingers-pattern-4 "\\d{50}" # If you use double quotes, you'll need to escape backslashes for special characters to work
set -g @fingers-pattern-5 \\d{50} # Escaping also needed if you don't use any quotes
Patterns use PCRE pattern syntax.
If the introduced regex contains an error, an error will be shown when invoking the plugin.
default: :copy:
By default tmux-fingers will copy matches in tmux and system clipboard.
If you still want to set your own custom command you can do so like this:
set -g @fingers-main-action '<your command here>'
This command will also receive the following:
MODIFIER
: environment variable set toctrl
,alt
, orshift
specififying which modifier was used when selecting the match.HINT
: environment variable the selected letter hint itself ( ex:q
,as
, etc... ).stdin
: copied text will be piped to@fingers-copy-command
.
You can also use the following special values:
:paste:
Copy the the match and paste it automatically.:copy:
Uses built-in system clipboard integration to copy the match.:open:
Uses built-in open file integration to open the file ( opens URLs in default browser, files in OS file navigator, etc ).
default: :open:
Same as @fingers-main-action but only called when match is selected by holding ctrl
Same as @fingers-main-action but only called when match is selected by holding alt
default: :paste:
Same as @fingers-main-action but only called when match is selected by holding shift
default: "fg=green,bold
With this option you can define the styles for the letter hints.
You can customize the styles using the same syntax used in .tmux.conf
for styling the status bar.
More info in the STYLES
section of man tmux
.
Supported styles are: bright
, bold
, dim
, underscore
, italics
.
default: "fg=yellow"
Custom styles for the highlighted match. See @fingers-hint-format for more details.
default: ""
Custom styles for all the text that is not matched. See @fingers-hint-format for more details.
default: "fg=blue,bold"
Format for hints in selected matches in multimode.
default: "fg=blue"
Format for selected matches in multimode.
default: "left"
Control the position where the hint is rendered. Possible values are "left"
and "right"
.
default: "qwerty"
Hints are generated taking optimal finger movement into account. You can choose between the following:
qwerty
: the default, use all lettersqwerty-left-hand
: only use letters easily reachable with left handqwerty-right-hand
: only use letters easily reachable with right handqwerty-homerow
: only use letters in the homerowqwertz
qwertz-left-hand
qwertz-right-hand
qwertz-homerow
azerty
azerty-left-hand
azerty-right-hand
azerty-homerow
colemak
colemak-left-hand
colemak-right-hand
colemak-homerow
dvorak
dvorak-left-hand
dvorak-right-hand
dvorak-homerow
default: 0
Show a message using tmux display-message
notifying about the copied result.
default: all
A list of comma separated pattern names. Built-in patterns are the following:
Name | Description | Example |
---|---|---|
ip | ipv4 addresses | 192.168.0.1 |
uuid | uuid identifier | f1b43afb-773c-4da2-9ae5-fef1aa6945ce |
sha | sha identifier | c8b911e2c7e9a6cc57143eaa12cad57c1f0d69df |
digit | four or more digits | 1337 |
url | urls (supported protocols: http/https/git/ssh/file) | https://asdf.com |
path | file paths | path/to/file |
hex | hexidecimal numbers | 0x00FF |
kubernetes | kubernetes identifer | deployment.apps/zookeeper |
git-status | will match file paths in the output of git status | modified: ./path/to/file |
git-status-branch | will match branch name in the output of git status | Your branch is up to date withname-of-branch |
diff | will match paths in diff output | +++ a/path/to/file |
You can start tmux-fingers without having to press tmux prefix by adding bindings like this:
# tmux.conf
# Start tmux fingers by pressing Alt+F
bind -n M-f run -b "#{@fingers-cli} start #{pane_id}"
# Start tmux fingers in jump mode by pressing Alt+J
bind -n M-j run -b "#{@fingers-cli} start #{pane_id} --mode jump"
You can start tmux-fingers with an specific set of built-in or custom patterns.
# match urls with prefix + u
bind -n u run -b "#{@fingers-cli} start #{pane_id} --patterns url"
# match hashes with prefix + h
bind -n h run -b "#{@fingers-cli} start #{pane_id} --patterns sha"
# match git stuff with prefix + g
bind -n g run -b "#{@fingers-cli} start #{pane_id} --patterns git-status,git-status-branch"
# match custom pattern with prefix + y
set -g @fingers-pattern-yolo "yolo.*"
bind -n y run -b "#{@fingers-cli} start #{pane_id} --patterns yolo"
This plugin is heavily inspired by
tmux-copycat ( tmux-fingers
predefined search are copycatted from
tmux-copycat ).
Kudos to bruno- for paving the way to tmux plugins! 👏 👏