# tmux.Server.SearchClients

- **Module:** tmux.Server
- **Package:** github.com/libtmux/libtmux-go/tmux
- **Language:** Go
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-go/blob/52968a3181c1c9e6d1b26c565d4b170968ae61c0/tmux/search.go#L42
- **Page:** https://libtmux.org/en/go/latest/reference/tmux-server-searchclients/

```
tmux.Server.SearchClients(ctx: context.Context, filter: *TmuxFilter) -> ([]Client, error)
```

SearchClients returns a newly materialized snapshot projection of clients selected by tmux's live -f expression. A nil filter omits -f and requests the unfiltered listing on every supported tmux version. A nonnil filter, including an empty expression, requires tmux 3.4 or newer and otherwise returns [VersionTooLowError].