Metadata-Version: 2.1
Name: nestmux
Version: 0.1.2
Summary: 
Author: Oivvio Polite
Author-email: oivvio@liberationtech.net
Requires-Python: >=3.9,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: libtmux (>=0.23.2,<0.24.0)
Description-Content-Type: text/markdown

# Nestmux - nested tmux

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

- Nicer error messages.

- Command to show config.

- Command to list current sessions.

- Command to attach to specific session.

- Add FOSS license

- Move to github

