1
1
mirror of https://github.com/wez/wezterm.git synced 2024-12-25 22:33:52 +03:00
wezterm/docs/copymode.md
Wez Furlong 8ce376753f round out quick select mode
* Make alphabet and patterns configurable
* add docs
* Enhance scrollback search to support regex captures so that
  searching for eg: `fo(o)` will select the last `o` in `foo`.

refs: https://github.com/wez/wezterm/issues/732
2021-04-25 16:27:39 -07:00

68 lines
2.5 KiB
Markdown

## Copy Mode
*since: 20200607-144723-74889cd4*
Copy mode allows you to make selections using the keyboard; no need to reach
for your mouse or trackpad. Copy mode is similar to [quick select
mode](quickselect.md) but is geared up for describing selections based on
keyboard control, whereas quick select mode is used to quickly select and
copy commonly used patterns.
The `ActivateCopyMode` key assignment is used to enter copy mode; it is
bound to `CTRL-SHIFT-X` by default.
When copy mode is activated, the title is prefixed with "Copy Mode" and
the behavior of the tab is changed; keyboard input now controls the
cursor and allows moving it through the scrollback, scrolling the viewport
as needed, in a style similar to that of the Vim editor.
Move the cursor to the start of the region you wish to select and press `v` to
toggle selection mode (it is off by default), then move the cursor to the end
of that region. You can then use `Copy` (by default: `CTRl-SHIFT-C`) to copy
that region to the clipboard.
### Key Assignments
The key assignments in copy mode are as follows. They are not currently
reassignable.
| Action | Key Assignment |
|---------|-------------------|
| Exit copy mode | `Esc` |
| | `CTRL-C` |
| | `CTRL-g` |
| | `q` |
| Toggle cell selection mode | `v` |
| Move Left | `LeftArrow`|
| | `h` |
| Move Down | `DownArrow`|
| | `j` |
| Move Up | `UpArrow` |
| | `k` |
| Move Right | `RightArrow`|
| | `l` |
| Move forward one word | `Alt-RightArrow` |
| | `Alt-f` |
| | `Tab` |
| | `w` |
| Move backward one word| `Alt-LeftArrow` |
| | `alt-b` |
| | `Shift-Tab` |
| | `b` |
| Move to start of this line | `0` |
| Move to start of next line | `Enter` |
| Move to end of this line | `$` |
| Move to start of indented line | `Alt-m` |
| | `^` |
| Move to bottom of scrollback | `G` |
| Move to top of scrollback | `g` |
| Move to top of viewport | `H` |
| Move to middle of viewport | `M` |
| Move to bottom of viewport | `L` |
| Move up one screen | `PageUp` |
| | `CTRL-b` |
| Move down one screen | `PageDown` |
| | `CTRL-f` |