Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
:computer: tmux session manager in python - json, yaml, python API
Python Shell

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
doc
examples
manual
pkg
tmuxp
.gitignore
.gitmodules
.tmuxp.yaml
.travis.yml
CHANGES
LICENSE
MANIFEST.in
README.rst
TODO
main.py
requirements.pip
run_tests.py
setup.py

README.rst

tmuxp solves the panes / pains of managing workspaces.

https://travis-ci.org/tony/tmuxp.png?branch=master https://badge.fury.io/py/tmuxp.png
https://raw.github.com/tony/tmuxp/master/doc/_static/tmuxp-dev-screenshot.png

Open to testers

tmuxp is still alpha code and needs a few more weeks until stable. See the Issues tracker to see known issues and for any other concerns.

tmux bash completion

$ tmuxp attach-session<tab>
# tmuxp will also automatically ``switch-client`` if you are already
# inside a tmux client.
$ tmuxp kill-session<tab>
$ tmuxp load<tab>
# load a session configuration with windows, panes, autocommands from
# a YAML or JSON file.

See: bash completion

load tmux sessions from yaml and json

$ tmuxp load .

Load from ~/.tmuxp.yaml or ~/.tmuxp.json in current directory.

$ tmuxp load myconfig.yaml

Load myconfig.yaml, checking current directory, then $HOME/.tmuxp/myconfig.yaml.

tmuxp will prompt you if session is already running, press [Enter] to attach the session automatically.

If you load a config from inside tmux, tmuxp will offer to attach it for you.

See: Examples

Install

  • install tmux, at least version 1.8
  • libyaml is installed for your distribution.

Install tmuxp:

$ pip install tmuxp

$ mkdir ~/.tmuxp and make a file ~/.tmuxp/test.yaml.

session_name: my session
windows:
- window_name: my test window
  shell_command_before: cd ~
  panes:
  - pwd
  - pwd

With tmuxp:

$ tmuxp load test.yaml

See also: Quickstart

tmux support 1.8, 1.9-dev
config support yaml, json, python dict
Travis http://travis-ci.org/tony/tmuxp
Docs http://tmuxp.rtfd.org
API http://tmuxp.readthedocs.org/en/latest/api.html
Changelog http://tmuxp.readthedocs.org/en/latest/changes.html
Issues https://github.com/tony/tmuxp/issues
Source https://github.com/tony/tmuxp
pypi https://pypi.python.org/pypi/tmuxp
License BSD.
git repo
$ git clone https://github.com/tony/tmuxp.git
install dev
$ git clone https://github.com/tony/tmuxp.git tmuxp
$ cd ./tmuxp
$ virtualenv .env
$ source .env/bin/activate
$ pip install -e .

See the developing and testing page in the docs for more.

tests
$ python ./run_tests.py
Something went wrong with that request. Please try again.