.. _glossary:

========
Glossary
========


.. glossary::

    libtmux
        Python library for interfacing with tmux through its objects.

    tmuxp
        A tool to manage workspaces with tmux, built on libtmux.

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

    kaptan
        configuration management library, see `kaptan on github`_.

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

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

        A server contains :term:`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 :term:`server`.  When you use tmux through CLI,
        you are using tmux as a client.

    Session
        Inside a tmux :term:`server`.
            
        The session has 1 or more :term:`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 :term:`session`.

        Can have 1 or more :term:`pane`.

        Panes can be organized with a layouts.

        Windows can have names.

    Pane
        Linked to a :term:`Window`.

        a pseudoterminal.

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

.. _kaptan on github: https://github.com/emre/kaptan
