Skip to main content

Simple tmux launcher that will take less than 2 minutes to learn and should work across all versions of tmux

Project description

smux

The minimal tmux launcher, with the fewest options to set and the fastest ramp-up time.

Originally created to be tool to make it easier to reproduce (and interactively debug) distributed systems bugs that required sshing into a lot of servers and starting processes, smux is a general purpose tmux launcher whose input resembles in all respects a concatenation of bash scripts to be run on each terminal.

Dependencies

  • Python2
  • tmux (any version)

Installation

Run the following command:

sudo pip install smux

Usage (as a command line tool)

  1. Create a new file, either from scratch or by copying Sample.smux.

  2. (Optional) Specify PANES_PER_WINDOW and LAYOUT as described in the usage message.

  3. For every pane you want to launch, write an entry of the following form.:

    ---------
    command1
    command2
    command3
    

    Note that a pane does not necessary need to run any commands.

    Note further that it is not uncommon for the first command in a pane to be ssh ... and then the subsequent commands the ones to be run on the rmeote server.

  4. smux.py <input_file_name>

Usage (as a library)

smux has a single API call create:

import smux

smux.create(numPerWindow,
        [["command1_for_pane1", "command2_for_pane1"],
         ["command1_for_pane2", "command2_for_pane2"],
         ...
         ])

Project details


Release history Release notifications

This version

0.6

Download files

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

Files for smux, version 0.6
Filename, size File type Python version Upload date Hashes
Filename, size smux-0.6.tar.gz (4.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page