From ArchWiki
Revision as of 15:27, 10 February 2017 by Git-pull (talk | contribs) (Initial tmuxp page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

tmuxp is a session manager for the tmux terminal multiplexer. Compare to tmuxinator or teamocil.


Install the tmuxpAUR through AUR.

tmuxp can also be installed via pip like this:

$ pip install --user tmuxp


tmuxp accepts both JSON and YAML configurations. The YAML markup is similar to tmuxinator's.

You can put configurations in any directory to access them via 3 ways:

  1. Via absolute or relative file path $ tmuxp load <file>, $ tmuxp load ../myconfig
  2. In the ``TMUXP_CONFIGDIR`` (default $HOME/.tmuxp) and access them via $tmuxp load <basename>. So $HOME/.tmuxp/myconfig.yaml would be loadable via $tmuxp load myconfig.
  3. Via .tmuxp.yaml in a project or directory (so you can store configs in a VCS per-project / folder. And then $ tmuxp load path/to/dir

A sample YAML configuration with 4 panes:

session_name: 4-pane-split
- window_name: dev window
  layout: tiled
    - cd ~/                    # run as a first command in all panes
    - shell_command:           # pane no. 1
        - cd /var/log          # run multiple commands in this pane
        - ls -al | grep \.log
    - echo second pane         # pane no. 2
    - echo third pane          # pane no. 3
    - echo forth pane          # pane no. 4