# libtmux.Pane.set_option

- **Module:** libtmux.Pane
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/036c521c4b83ce6e434eb50afe2a0d08a6a05e46/src/libtmux/options.py#L593
- **Page:** https://libtmux.org/reference/py/libtmux-pane-set_option/

```
libtmux.Pane.set_option(self, option: str, value: int | str, _format: bool | None = None, prevent_overwrite: bool | None = None, ignore_errors: bool | None = None, suppress_warnings: bool | None = None, append: bool | None = None, g: bool | None = None, global_: bool | None = None, scope: OptionScope | _DefaultOptionScope | None = DEFAULT_OPTION_SCOPE) -> Self
```

Set option for tmux target.

Wraps ``$ tmux set-option <option> <value>``.

## Parameters

- `self`
- `option` (str) — option to set, e.g. 'aggressive-resize'
- `value` (int | str) — option value. True/False will turn in 'on' and 'off',
also accepts string of 'on' or 'off' directly.
- `_format` (bool | None)
- `prevent_overwrite` (bool | None)
- `ignore_errors` (bool | None)
- `suppress_warnings` (bool | None)
- `append` (bool | None)
- `g` (bool | None)
- `global_` (bool | None)
- `scope` (OptionScope | _DefaultOptionScope | None)

## Raises

- `exc.OptionError`
- `exc.UnknownOption`
- `exc.InvalidOption`
- `exc.AmbiguousOption`

## Example

```python
>>> import typing as t
>>> from libtmux.common import tmux_cmd
>>> from libtmux.constants import OptionScope
>>> from libtmux._internal.sparse_array import SparseArray
```

## Example

```python
>>> class MyServer(OptionsMixin):
...     socket_name = server.socket_name
...     def cmd(self, cmd: str, *args: object):
...         cmd_args: t.List[t.Union[str, int]] = [cmd]
...         if self.socket_name:
...             cmd_args.insert(0, f"-L{self.socket_name}")
...         cmd_args.insert(0, "-f/dev/null")
...         return tmux_cmd(*cmd_args, *args)
...
...     default_option_scope = OptionScope.Server
```

## Example

```python
>>> MyServer().set_option('escape-time', 1250)
<libtmux.options.MyServer object at ...>
```

## Example

```python
>>> MyServer()._show_option('escape-time')
1250
```

## Example

```python
>>> MyServer().set_option('escape-time', 495)
<libtmux.options.MyServer object at ...>
```

## Example

```python
>>> MyServer()._show_option('escape-time')
495
```
