Python API

class libtmux stable

Server

tmux(1) Server [server_manual].

Base types EnvironmentMixinOptionsMixinHooksMixin

Source and package

Qualified name: libtmux.Server
Module: libtmux
Package: libtmux
Source: src/libtmux/server.py
Other languages: PowerShellcmdlet Juliastruct RubyLuaTypeScriptRustGoJavaC#C++SwiftKotlinScalaF#module

class libtmux.Server class [source] ¶

Description#

Server.sessions [ Session , ...]
- Session.windows [ Window , ...]
  - Window.panes [ Pane , ...]
    - Pane

When instantiated stores information on live, running tmux server.

Examples#

>>> server
Server(socket_name=libtmux_test...)

>>> server.sessions
[Session($1 ...)]

>>> server.sessions[0].windows
[Window(@1 1:..., Session($1 ...))]

>>> server.sessions[0].active_window
Window(@1 1:..., Session($1 ...))

>>> server.sessions[0].active_pane
Pane(%1 Window(@1 1:..., Session($1 ...)))

The server can be used as a context manager to ensure proper cleanup:

>>> with Server() as server:
...     session = server.new_session()
...     # Do work with the session
...     # Server will be killed automatically when exiting the context

References#

[server_manual]: CLIENTS AND SESSIONS. openbsd manpage for TMUX(1) "The tmux server manages clients, sessions, windows and panes. Clients are attached to sessions to interact with them, either when they are created with the new-session command, or later with the attach-session command. Each session has one or more windows linked into it. Windows may be linked to multiple sessions and are made up of one or more panes, each of which contains a pseudo terminal." https://man.openbsd.org/tmux.1#CLIENTS_AND_SESSIONS. Accessed April 1st, 2018.

Discussed in Server, session, window, pane · Attaching to tmux · Python workspace internal API · Architecture , Ownership and cleanup , Socket and servers

In other ports A tmux server

PowerShell
LibTmux\New-TmuxServer
This cmdlet constructs a shared .NET LibTmux.Server handle without contacting tmux.
Julia
LibTmux.Server
Server describes an endpoint without contacting tmux. Read its hierarchy with snapshot .
Ruby
LibTmux::Server
Lua
libtmux.Server
TypeScript
server.Server
Rust
server.Server
Go
tmux.Server
Java
io.github.libtmux.Server
C#
LibTmux.Server
C++
libtmux::Server
Swift
Server
Kotlin
io.github.libtmux.kotlin.Server
Scala
io.github.libtmux.scaladsl.Server
F#
LibTmux.FSharp.Server
This F# module provides functions over the shared .NET LibTmux.Server type.

Members74#

Collections and queries11#

sessions property Sessions contained in server.
windows property Windows contained in server's sessions.
panes property Panes contained in tmux server (across all windows in all sessions).
clients property Clients attached to this tmux server.
list_buffers method List paste buffers via $ tmux list-buffers.
list_commands method List tmux commands via $ tmux list-commands.
list_keys method List key bindings via $ tmux list-keys.
list_clients method List connected clients via $ tmux list-clients.
search_panes method All panes across the server, optionally filtered by tmux.
search_sessions method Sessions, optionally filtered by tmux before rows are returned.
search_windows method All windows across sessions, optionally filtered by tmux.

Common operations40#

new_session method Create new session, returns new Session .
kill method Kill tmux server.
source_file method Source a tmux configuration file via $ tmux source-file.
set_buffer method Set a paste buffer via $ tmux set-buffer.
is_alive method Return True if tmux server alive.
show_buffer method Show content of a paste buffer via $ tmux show-buffer.
delete_buffer method Delete a paste buffer via $ tmux delete-buffer.
run_shell method Execute a shell command via $ tmux run-shell.
has_session method Return True if session exists.
cmd method Execute tmux command respective of socket name and file, return output.
wait_for method Wait for, signal, or lock a channel via $ tmux wait-for.
load_buffer method Load a file into a paste buffer via $ tmux load-buffer.
save_buffer method Save a paste buffer to a file via $ tmux save-buffer.
bind_key method Bind a key to a command via $ tmux bind-key.
unbind_key method Unbind a key via $ tmux unbind-key.
if_shell method Execute a tmux command conditionally via $ tmux if-shell.
show_prompt_history method Show prompt history via $ tmux show-prompt-history.
clear_prompt_history method Clear prompt history via $ tmux clear-prompt-history.
lock_server method Lock the tmux server via $ tmux lock-server.
raise_if_dead method Raise if server not connected.
start_server method Start the tmux server via $ tmux start-server.
show_messages method Show server message log via $ tmux show-messages.
command_prompt method Open a command prompt via $ tmux command-prompt.
display_message method Display message at server scope via $ tmux display-message.
detach_client method Detach a specific client via $ tmux detach-client.
kill_session method Kill tmux session.
from_env method Return the tmux server this process's pane is attached to.
config_file attribute Passthrough to [-f file]
socket_path attribute Passthrough to [-S socket-path]
attached_sessions property Return active Session instances.
confirm_before method Run a command after confirmation via $ tmux confirm-before.
display_menu method Display a popup menu via $ tmux display-menu.
detach_all_clients method Detach every client on this server via $ tmux detach-client -a.
lock_client method Lock a client via $ tmux lock-client.
suspend_client method Suspend a client via $ tmux suspend-client.
refresh_client method Refresh a client's display via $ tmux refresh-client.
switch_client method Switch tmux client.
colors attribute 256 or 88
socket_name attribute Passthrough to [-L socket-name]
server_access method Manage server access control via $ tmux server-access.

Other members23#

attach_session method Attach tmux session.
child_id_attribute attribute Unique child ID used by TmuxRelationalObject
default_hook_scope: OptionScope | None attribute For hook management.
default_option_scope: OptionScope | None attribute For option management.
formatter_prefix attribute Namespace used for TmuxMappingObject
tmux_bin: str | None attribute Custom path to tmux binary. Falls back to shutil.which("tmux").
children property Was used by TmuxRelationalObject (but that's longer used in this class).
find_where method Filter through sessions, return first Session .
get_by_id method Return session by id. Deprecated in favor of sessions.get().
kill_server method Kill tmux server.
list_sessions method Return list of Session from the tmux(1) session.
where method Filter through sessions, return list of Session .
__enter__ method Enter the context, returning self.
__eq__ method Equal operator for Server object.
__exit__ method Exit the context, killing the server if it exists.
__init__ method
__repr__ method Representation of Server object.
_list_panes method Return list of panes in dict form.
_list_sessions method Return list of session object dictionaries.
_list_windows method Return list of windows in dict form.
_sessions property Property / alias to return _list_sessions .
_update_panes method Update internal pane data and return self for chainability.
_update_windows method Update internal window data and return self for chainability.

Inherited members24 members#

Reached through libtmux.options.OptionsMixin, libtmux.hooks.HooksMixin, libtmux.common.EnvironmentMixin.

show_options method inherited Return all options for the target.
show_hooks method inherited Return a dict of hooks for the target.
show_environment method inherited Show environment $ tmux show-environment -t [session].
set_option method inherited Set option for tmux target.
set_environment method inherited Set environment $ tmux set-environment <name> <value>.
unset_environment method inherited Unset environment variable $ tmux set-environment -u <name>.
unset_option method inherited Unset option for tmux target.
show_option method inherited Return option value for the target.
set_hook method inherited Set hook for tmux target.
unset_hook method inherited Unset hook for tmux target.
remove_environment method inherited Remove environment variable $ tmux set-environment -r <name>.
set_hooks method inherited Set multiple indexed hooks at once.
show_hook method inherited Return value for a hook.
getenv method inherited Show environment variable $ tmux show-environment -t [session] <name>.
hooks attribute inherited
run_hook method inherited Run a hook immediately. Useful for testing.
_add_option attribute inherited
_show_hook method inherited Return value for the hook.
_show_option method inherited Return option value for the target.
_show_option_raw method inherited Return raw option output for target.
_show_options method inherited Return a dict of options for the target.
_show_options_dict method inherited Return dict of options for the target.
_show_options_raw method inherited Return a dict of options for the target.
_tmux_bin property inherited Resolve tmux_bin from self (Server) or self.server (Session/Window/Pane).

Scripting & web

Compiled & native

JVM

.NET

tmux

Server

Description#

Examples#

References#

Members74#

Collections and queries11#

Common operations40#

Other members23#

Inherited members24 members#

Description#

Examples#

References#

Members74#

Collections and queries11#

Common operations40#

Other members23#

Inherited members24 members#

Related types#