On this page

libtmux.Window.linked_sessions

Module: libtmux
Declared in: Window
Package: libtmux
Source: src/libtmux/window.py

linked_sessions ( self ) → QueryList[Session] property [source] ¶ property [source] ¶ linked_sessions

Every session this window is reachable from.

Usually one, and then this is just Window.session in a list. link-window and grouped sessions (tmux new-session -t existing) make it more: the window is genuinely in each of them at once, and Window.session returns the session recorded on this Window instance.

Each session is listed once, however many indexes it links the window at, and they come back in the order tmux lists them. Fetching the holders takes two list commands total, independent of how many there are. If either listing fails, the result is empty.

Examples

A window you just made belongs to the session you made it in:

>>> window = session.new_window(window_name="solo", attach=False)
>>> [s.session_name for s in window.linked_sessions] == [session.session_name]
True

Link it into a second session and it belongs to both:

>>> guest = server.new_session(session_name="guest")
>>> target = f"{guest.session_id}:"
>>> _ = server.cmd("link-window", "-d", "-s", window.window_id, "-t", target)
>>> sorted(s.session_name for s in window.linked_sessions) == sorted(
...     [session.session_name, "guest"]
... )
True

Returns: QueryList of Session

0 declared, 0 inherited