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.

Source Distribution

smux-0.6.tar.gz (4.4 kB view hashes)

Uploaded source

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