# libtmux.Window.search_panes

- **Module:** libtmux.Window
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/036c521c4b83ce6e434eb50afe2a0d08a6a05e46/src/libtmux/window.py#L401
- **Page:** https://libtmux.org/reference/py/libtmux-window-search_panes/

```
libtmux.Window.search_panes(self, filter: str | None = None, # noqa: A002) -> QueryList[Pane]
```

Panes in this window, optionally filtered by tmux.

Like :attr:`Window.panes` but with a ``filter`` kwarg passed to
``$ tmux list-panes -t <window> -f <filter>``.

## Parameters

- `self`
- `filter` (str | None) — tmux format expression (``-f`` flag).
tmux silently expands a malformed filter (unclosed
``#{...}``, unknown format token) to empty, which the
filter treats as false — every row is suppressed and no
stderr is emitted. A bad filter is
indistinguishable from "filter matched nothing"; verify
filter syntax against the FORMATS section of ``tmux(1)``. Warning:
- `# noqa: A002`

## Example

```python
>>> target_pane = window.split()
>>> matches = window.search_panes(
...     filter=f'#{{m:{target_pane.pane_id},#{{pane_id}}}}'
... )
>>> [p.pane_id for p in matches] == [target_pane.pane_id]
True
```