Skip to main content

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"],
         ...
         ])

Metadata

Release files for smux 0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for smux 0.6
File Size Uploaded Provenance Actions
smux-0.6.tar.gz 4.4 kB Without provenance Details for smux-0.6.tar.gz

Release files / smux-0.6.tar.gz

Download URL smux-0.6.tar.gz
Size 4.4 kB
Tags Source
SHA-256 checksum
How to use checksums
6f6b956e87fb135e70200e023acbc9c62bc5f695ccccfd775bdd5314fd9ab4e9
BLAKE2b-256 checksum
How to use checksums
e12558db36b45087948b74e562bc1c3e9b8be69165dd41208937071fbd4ce083
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for smux 0.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.6 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page