# Pane interaction

Source: https://libtmux.org/en/rs/latest/topics/pane-interaction/

> Input defaults, screen capture, and waiting for a command to finish.

Send input to a pane and capture its screen to interact with a running program.
[Attach and send keys](https://libtmux.org/en/rs/latest/examples/attach-and-send-keys/) provides examples.
[Sending keys](https://libtmux.org/en/rs/latest/guides/sending-keys/) and [Capturing
output](https://libtmux.org/en/rs/latest/guides/capturing-output/) are task guides; this page covers input
defaults, capture ranges, and completion handling.

## Typing into a pane

Two questions come up every time you send something to a pane: should tmux
press Enter afterward, and should tmux interpret what you sent as key names
([`Enter`](https://libtmux.org/en/tmux/latest/manual/send-keys/), `C-c`) rather than literal characters? Choose both explicitly when
a command depends on them.

**Type without Enter:** [`pane.send_keys(keys)`](<https://libtmux.org/en/rs/latest/reference/pane-pane-send_keys/>): **always literal**, key names
typed as text

**Type + Enter (default):** [`pane.send_line(text)`](<https://libtmux.org/en/rs/latest/reference/pane-pane-send_line/>)

**How "literal" is chosen:** [`send_keys`](<https://libtmux.org/en/rs/latest/reference/pane-pane-send_keys/>) sends literal text; [`send_key_names`](<https://libtmux.org/en/rs/latest/reference/pane-pane-send_key_names/>)
interprets tmux key names.

### Examples

[`send_keys`](<https://libtmux.org/en/rs/latest/reference/pane-pane-send_keys/>) sends literal text. Use [`send_key_names`](<https://libtmux.org/en/rs/latest/reference/pane-pane-send_key_names/>) for tmux key names.
Passing `"Enter"` to [`send_keys`](<https://libtmux.org/en/rs/latest/reference/pane-pane-send_keys/>) types those characters. [`send_line`](<https://libtmux.org/en/rs/latest/reference/pane-pane-send_line/>) appends a
carriage return and delivers it with the text in one tmux command.

Send a command line and press Enter:

```rust
pane.send_keys("echo hi").await?; // Always literal text.
pane.send_line("echo hi").await?; // text and Enter in one send-keys -l call
```

## Reading a pane back

Capture reads the pane's visible screen by default. Request scrollback when
you need earlier output. A capture is a snapshot of terminal contents, including
any input echoed by the application.

```rust
pane.capture().await?;
```

## Waiting for something to finish

A send call completes when input reaches tmux. It does not wait for the shell
command to finish. Wait for expected output or a completion signal.

[Capture pane output](https://libtmux.org/en/rs/latest/examples/capture-pane-output/) shows capture and waiting
examples. [Waiting and retrying](https://libtmux.org/en/rs/latest/topics/waiting-and-retry/) explains completion
conditions and timeouts.

<details>
<summary>tmux manual and source</summary>

The tmux manual defines [key-name and literal input](https://github.com/tmux/tmux/blob/94796f6b1182507efac8a272fc309a79e22e58a5/tmux.1#L4457)
and [screen and history capture](https://github.com/tmux/tmux/blob/94796f6b1182507efac8a272fc309a79e22e58a5/tmux.1#L2798).
A send operation delivers input; it does not establish the program's exit status.

</details>