Glossary

tmuxp

A tool to manage workspaces with tmux. A pythonic abstraction of tmux.

tmux
tmux(1)

The tmux binary. Used internally to distinguish tmuxp is only a layer on top of tmux.

ConfigReader

configuration management class, for parsing YAML / JSON / etc. files to and from python data (dictionaries, in the future, potentially dataclasses)

Server

Tmux runs in the background of your system as a process.

The server holds multiple Session. By default, tmux automatically starts the server the first time $ tmux is ran.

A server contains session’s.

tmux starts the server automatically if it’s not running.

Advanced cases: multiple can be run by specifying [-L socket-name] and [-S socket-path].

Client

Attaches to a tmux server. When you use tmux through CLI, you are using tmux as a client.

Session

Inside a tmux server.

The session has 1 or more Window. The bottom bar in tmux show a list of windows. Normally they can be navigated with Ctrl-a [0-9], Ctrl-a n and Ctrl-a p.

Sessions can have a session_name.

Uniquely identified by session_id.

Window

Entity of a session.

Can have 1 or more pane.

Panes can be organized with a layouts.

Windows can have names.

Pane

Linked to a Window.

a pseudoterminal.

Target

A target, cited in the manual as [-t target] can be a session, window or pane.