Skip to content

CrispyConductor/tmux-copy-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tmux Rapid Copy Toolkit

This tmux plugin is intended to allow copying on-screen data as efficiently and in as few keystrokes as possible. It is inspired by several other tmux plugins including tmux-jump, tmux-fingers, tmux-open, and other similar ones. This plugin combines, improves, and adds functionality on top of a common interface, with particular attention paid to stability and reliability with respect to wrapped lines, panes, zooming, etc.

Features

There are 5 major modes/features:

easymotion

This is a reimplementation of the classic vim-style easymotion movement. It allows rapid seeking to anywhere in copy-mode in just a few keystrokes (typically 3 or 4).

In tmux copy-mode, hit the easymotion key (by default s), then enter the character at the desired seek destination. Each instance of that character will then be highlighted and replaced with one or more letters. Enter the letter(s) corresponding to the desired seek destination to seek there. The j, k, and n line-based actions are also supported.

This mode has several variants that can be configured using options.

easycopy

This is effectively two easymotion movements in series to set the start and end positions of a block of text to copy. This can be used outside of copy-mode. With default keybinds, it allows copying nearly any arbitrary block of text on screen in 8 keystrokes or less (including prefix).

To use, hit Ctrl-b S to activate easycopy mode. Then enter the character at the start of the region to copy, and key in the corresponding label that appears. Immediately after, enter the character at the end (inclusive) of the region to copy, then the corresponding label. The block will then flash to confirm and will be copied.

quickcopy

This mode allows copying some of the most common elements of text in even fewer keystrokes; as few as 3 (including prefix) for very commonly-copied things