Manage tmux workspaces from JSON and YAML, pythonic API, shell completion
Project description
tmuxp solves the panes / pains of managing workspaces.
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 |
|
Docs |
|
API |
|
Changelog |
|
Issues |
|
Source |
|
pypi |
|
License |
BSD. |
git repo |
|
install dev |
See the developing and testing page in the docs for more. |
tests |
|
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.