Manage tmux workspaces from JSON and YAML, pythonic API, shell completion

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for git-pull from gravatar.com git-pull

Unverified details

These details have not been verified by PyPI
Project links
Meta
Classifiers

Project description

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.

Install

  • install tmux, at least version 1.8

  • libyaml is installed for your distribution.

Install tmuxp:

$ pip install tmuxp

See: Quickstart

CLI Commands

tmuxp uses switch-client for you if already in a TMUX client.

$ tmuxp attach-session<tab> # current sessions

Kill session

$ tmuxp kill-session<tab> # current sessions

Load a session configuration from a YAML or JSON file.

$ tmuxp load<tab> # configs in config dir, current directory

Convert a session config JSON <=> YAML:

$ tmuxp convert<tab> # configs in config dir, current directory

Experimental: Import configuration from teamocil or tmuxinator:

$ tmuxp import teamocil<tab> # configs in ~/.teamocil dir
$ tmuxp import tmuxinator<tab> # configs in ~/.tmuxinator dir

See installing bash completion to get bash, zsh and tcsh completion working on your machine.

load tmux sessions from yaml and json

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

$ tmuxp load .

Load myconfig.yaml from ~/.tmuxp

$ tmuxp load myconfig.yaml

Load a relative or full config file (bash complete supports this too)

$ tmuxp load ./myconfig.yaml
$ tmuxp load ../myconfig.yaml
$ tmuxp load /var/www/mywebproject/myconfig.yaml

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

session_name: 2-pane-vertical
windows:
  - window_name: my test window
    panes:
      - pwd
      - pwd
$ tmuxp load test.yaml

or ~/.tmuxp/test.json:

{
  "windows": [
    {
      "panes": [
        "pwd",
        "pwd"
      ],
      "window_name": "my test window"
    }
  ],
  "session_name": "2-pane-vertical"
}
$ tmuxp load test.json

See: Examples

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-hypernode.com/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

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for git-pull from gravatar.com git-pull

Unverified details

These details have not been verified by PyPI
Project links
Meta
Classifiers

Release history Release notifications | RSS feed

1.47.0

1.46.0

1.46.0a0 pre-release

1.45.0

1.44.0

1.43.1

1.43.0

1.42.0

1.41.1

1.41.0

1.41.0b0 pre-release

1.40.0

1.39.0

1.38.0

1.37.1

1.37.0

1.36.0

1.35.0

1.34.0

1.33.0

1.32.1

1.32.0

1.31.0

1.30.1

1.30.0

1.30.0a0 pre-release

1.29.1

1.29.0.post0

1.29.0

1.28.2

1.28.1

1.28.0

1.27.1

1.27.0

1.26.0

1.25.0

1.24.1

1.24.0

1.24.0a0 pre-release

1.23.0 yanked

Reason this release was yanked:

tmuxp load errors

1.22.1

1.22.0

1.21.0

1.20.3

1.20.2

1.20.1

1.20.0

1.20.0a0 pre-release

1.19.1

1.19.0

1.19.0a1 pre-release

1.19.0a0 pre-release

1.18.2

1.18.1

1.18.0

1.18.0a0 pre-release

1.17.3

1.17.2

1.17.1

1.17.0

1.17.0a0 pre-release

1.16.2

1.16.1

1.16.0

1.16.0a0 pre-release

1.15.3

1.15.2

1.15.1

1.15.1a2 pre-release

1.15.1a1 pre-release

1.15.1a0 pre-release

1.15.0

1.14.0

1.14.0a1 pre-release

1.14.0a0 pre-release

1.13.3

1.13.2

1.13.1

1.13.0

1.13.0a2 pre-release

1.13.0a1 pre-release

1.13.0a0 pre-release

1.12.1

1.12.0

1.12.0a6 pre-release

1.12.0a5 pre-release

1.12.0a4 pre-release

1.12.0a3 pre-release

1.12.0a2 pre-release

1.12.0a1 pre-release

1.12.0a0 pre-release

1.11.1

1.11.0

1.11.0b3 pre-release

1.11.0b2 pre-release

1.11.0b1 pre-release

1.11.0b0 pre-release

1.10.1

1.10.0

1.10.0b6 pre-release

1.10.0b5 pre-release

1.10.0b4 pre-release

1.10.0b3 pre-release

1.10.0b2 pre-release

1.10.0b1 pre-release

1.10.0b0 pre-release

1.9.4

1.9.3

1.9.2

1.9.1

1.9.0

1.8.2

1.8.1

1.8.0.post0

1.8.0

1.7.2

1.7.1

1.7.0

1.7.0a4 pre-release

1.7.0a3 pre-release

1.7.0a2 pre-release

1.7.0a1 pre-release

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.8

1.5.7.post0

1.5.7 yanked

Reason this release was yanked:

leftover print statements in tmuxp load

1.5.6

1.5.5

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.5.0a1 pre-release

1.4.2

1.4.1

1.4.0

1.3.5

1.3.4

1.3.3

1.3.2

1.3.1

1.3.0

1.2.8

1.2.7

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.1

1.1.0

1.0.2

1.0.1

1.0.0

1.0.0rc1 pre-release

0.11.0

0.10.0

0.9.3

0.9.2

0.9.1

0.9.0

0.8.1

0.8.0

0.1.13

0.1.12

0.1.11

0.1.10

0.1.9

0.1.8

0.1.7

0.1.6

0.1.5.1

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

0.1.0rc8 pre-release

0.1.0rc7 pre-release

0.1.0rc6 pre-release

0.1.0rc5 pre-release

0.1.0rc4 pre-release

0.1.0rc3 pre-release

0.1.0rc2 pre-release

0.1.0rc1 pre-release

0.0.44

0.0.44a pre-release

0.0.43

0.0.42

0.0.41

0.0.40

0.0.39

0.0.38

0.0.37

0.0.37a pre-release

0.0.36

0.0.35

0.0.34

0.0.33

0.0.32

0.0.31

0.0.30

0.0.30a pre-release

0.0.29

0.0.28

0.0.27

0.0.26

0.0.25

0.0.24

0.0.23

This version

0.0.22

0.0.21

0.0.20

0.0.19

0.0.18

0.0.17

0.0.16-dev pre-release

0.0.15-dev pre-release

0.0.14-dev pre-release

0.0.13-dev pre-release

0.0.12-dev pre-release

0.0.11-dev pre-release

0.0.10-dev pre-release

0.0.9-dev pre-release

0.0.8-dev pre-release

0.0.7-dev pre-release

0.0.6-dev pre-release

0.0.5-dev pre-release

0.0.4-dev pre-release

0.0.3-dev pre-release

0.0.2-dev pre-release

0.0.1-dev pre-release

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tmuxp-0.0.22.tar.gz (54.4 kB view details)

Uploaded Source

File details

Details for the file tmuxp-0.0.22.tar.gz.

File metadata

  • Download URL: tmuxp-0.0.22.tar.gz
  • Upload date:
  • Size: 54.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for tmuxp-0.0.22.tar.gz
Algorithm Hash digest
SHA256 4b70e2b84cdd804845683ed12b405ecfed2c657efc4865abd73a7072ae258309
MD5 2bb730694595c7a269efcd7fbc9a2dac
BLAKE2b-256 f94fcca885b2aeaf7f232d2d147d843786516af100f4e2061cb79bfa15748a75

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page