Python API

libtmux.Server.search_windows

Python

Python
Ruby Unavailable
Lua Unavailable
TypeScript Unavailable
Rust Unavailable
Go
Java Unavailable
.NET
C++ Unavailable
Swift Unavailable

Module: libtmux
Declared in: Server
Package: libtmux
Source: src/libtmux/server.py
Other languages: Ruby Lua TypeScript Rust Go Java .NET C++ Swift

search_windows ( self , filter : str | None = None , # noqa: A002 ) → QueryList[Window] method [source] ¶ method [source] ¶ search_windows

All windows across sessions, optionally filtered by tmux.

Like Server.windows but with a filter kwarg passed to $ tmux list-windows -a -f <filter>.

Examples

>>> sess = server.new_session(session_name='gap7_win_demo')
>>> _ = sess.new_window(window_name='gap7_target')
>>> _ = sess.new_window(window_name='other_window')
>>> matches = server.search_windows(filter='#{m:gap7_*,#{window_name}}')
>>> any(w.window_name == 'gap7_target' for w in matches)
True
>>> any(w.window_name == 'other_window' for w in matches)
False

Parameters

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: added 0.57

In other ports Filter every window with a tmux expression

Ruby No source-verified Ruby equivalent is recorded for this operation.
Lua No source-verified Lua equivalent is recorded for this operation.
TypeScript no equivalent on Server
Rust no equivalent on Server
Go tmux.Server.SearchWindows
Java no equivalent on Server
.NET LibTmux.Server.SearchWindowsAsync
C++ no equivalent on Server
Swift no equivalent on Server

0 declared, 0 inherited