# io.github.libtmux.control.ControlClient.ControlClient.subscribeOutput

- **Module:** io.github.libtmux.control.ControlClient.ControlClient
- **Package:** io.github.libtmux:libtmux
- **Language:** Java
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-java/blob/842228310449e879ebcaa3f910597757c9dbffd6/libtmux/src/main/java/io/github/libtmux/control/ControlClient.java#L248
- **Page:** https://libtmux.org/en/java/latest/reference/io-github-libtmux-control-controlclient-controlclient-subscribeoutput/

```
io.github.libtmux.control.ControlClient.ControlClient.subscribeOutput(capacity: int) -> EventSubscription<PaneOutput>
```

Subscribes to terminal output tmux pushes.

## Parameters

- `capacity` (int): how many values this subscriber can retain before its oldest value is dropped

## Returns

a pull subscription owned by the caller

## Raises

- `IllegalArgumentException`: if {@code capacity} is not positive
- `IllegalStateException`: if the client has ended