Skip to main content

Run nested tmux sessions with ease

Project description

Nestmux - Run nested tmux sessions with ease

Running nested sessions of tmux is a bit of a hassle. nestmux is here to make it easier.

Installation

pip install nestmux

Usage

The first invocation of nestmux will create a new tmux session with the prefix key C-h.

Invoking nestmux again inside the first session will create a nested session with the prefix key C-n.

Invoking nestmux again inside the second session will create a second nested session with the prefix key C-b.

Configuration

nestmux is configured with a json file located at ~/.config/nestmux/nestmux.json. The default configuration is

{
	"prefixes": ["C-h", "C-n", "C-b"],
	"socket_name": "NESTMUX"
}

prefixes is an arbitrarily long ordered list of prefix keys, where the first element will be the prefix key for the first nesting level and so on. The length of this list controls the maximum nesting depth.

socket_name is the name of the tmux socket. There's rarely a point in setting this to anything other than the default.

Things to fix

  • Replace attach_session with a function replaces the current python process with the tmux process we attach to, instead of adding the tmux process as a child process of the current python process.

  • Add a video to the README.

  • Change to TOML for config

  • Nicer error messages.

  • Command to validate config.

  • Command to show config.

Project details


Download files

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

Source Distribution

nestmux-0.1.4.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nestmux-0.1.4-py3-none-any.whl (5.0 kB view details)

Uploaded Python 3

File details

Details for the file nestmux-0.1.4.tar.gz.

File metadata

  • Download URL: nestmux-0.1.4.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.9.17 Darwin/23.1.0

File hashes

Hashes for nestmux-0.1.4.tar.gz
Algorithm Hash digest
SHA256 934508ca2a3611a31e751df44b63d1d10ea09d9a3f826e0e18c52e16773ca012
MD5 0da3fe7d53cd0dfa5578ffaf566a98d7
BLAKE2b-256 b3a504bf3a3a5e83cc82871ed436c3bba4c75890b11f657bb3da15447ed2e4c6

See more details on using hashes here.

File details

Details for the file nestmux-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: nestmux-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 5.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.9.17 Darwin/23.1.0

File hashes

Hashes for nestmux-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 25ed9ccfb993342d17c2133b98f68a4c68d8af61e480fac9a45d4afa8c5005c3
MD5 8bb2468de0d0493ad8ad878bed53e573
BLAKE2b-256 d1e2d645a8ac0614465267e8359c5cea179332d08d301378ed46d41980639294

See more details on using hashes here.

Supported by

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