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


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.


  • Python2
  • tmux (any version)


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.:


    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. <input_file_name>

Usage (as a library)

smux has a single API call create:

import smux

        [["command1_for_pane1", "command2_for_pane1"],
         ["command1_for_pane2", "command2_for_pane2"],

Project details

Release history Release notifications | RSS feed

This version


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

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page