# libtmux.hooks.HooksMixin.set_hooks

- **Module:** libtmux.hooks
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/38e368c11117fb4aeb2f082d552cd4f210eae06a/src/libtmux/hooks.py#L437
- **Page:** https://libtmux.org/en/py/stable/reference/libtmux-hooks-hooksmixin-set_hooks/

tmux catalog: [Hooks](/en/tmux/latest/catalog/hooks/)

```
libtmux.hooks.HooksMixin.set_hooks(
    self,
    hook: str,
    values: HookValues,
    clear_existing: bool = False,
    global_: bool | None = None,
    scope: OptionScope
    | _DefaultOptionScope
    | None = DEFAULT_OPTION_SCOPE,
) -> Self
```

Set multiple indexed hooks at once.

## Examples

Set hooks with explicit indices:

```python
>>> session.set_hooks('session-renamed', {
...     0: 'display-message "hook 0"',
...     1: 'display-message "hook 1"',
... })
Session($...)
```

```python
>>> hooks = session.show_hook('session-renamed')
>>> sorted(hooks.keys())
[0, 1]
```

```python
>>> session.unset_hook('session-renamed')
Session($...)
```

Set hooks from a list (sequential indices):

```python
>>> session.set_hooks('after-new-window', [
...     'select-pane -t 0',
...     'send-keys "clear" Enter',
... ])
Session($...)
```

```python
>>> hooks = session.show_hook('after-new-window')
>>> sorted(hooks.keys())
[0, 1]
```

Replace all existing hooks with ``clear_existing=True``:

```python
>>> session.set_hooks(
...     'session-renamed',
...     {0: 'display-message "new"'},
...     clear_existing=True,
... )
Session($...)
```

```python
>>> hooks = session.show_hook('session-renamed')
>>> sorted(hooks.keys())
[0]
```

```python
>>> session.unset_hook('session-renamed')
Session($...)
```

```python
>>> session.unset_hook('after-new-window')
Session($...)
```

## Parameters

- `hook` (`str`): Hook name, e.g. 'session-renamed'
- `values` (`HookValues`): Values to set. Can be:
- dict[int, str]: {0: 'cmd1', 1: 'cmd2'} - explicit indices
- SparseArray[str]: preserves indices from another hook
- list[str]: ['cmd1', 'cmd2'] - sequential indices starting at 0
- `clear_existing` (`bool`): If True, unset all existing hook values first
- `global_` (`bool | None`): Use global hooks
- `scope` (`OptionScope | _DefaultOptionScope | None`): Scope for the hook

## Returns

Self
    Returns self for method chaining.