# 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.
Raw data
{
"_id": null,
"home_page": "https://github.com/oivvio/nestmux",
"name": "nestmux",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "",
"keywords": "tmux,cli",
"author": "Oivvio Polite",
"author_email": "nestmux@liberationtech.net",
"download_url": "https://files.pythonhosted.org/packages/b3/a5/04bf3a3a5e83cc82871ed436c3bba4c75890b11f657bb3da15447ed2e4c6/nestmux-0.1.4.tar.gz",
"platform": null,
"description": "# Nestmux - Run nested tmux sessions with ease\n\nRunning nested sessions of `tmux` is a bit of a hassle. `nestmux` is here to make it easier.\n\n## Installation\n\n pip install nestmux\n\n## Usage\n\nThe first invocation of `nestmux` will create a new `tmux` session with the prefix key `C-h`.\n\nInvoking `nestmux` again inside the first session will create a nested session with the prefix key `C-n`.\n\nInvoking `nestmux` again inside the second session will create a second nested session with the prefix key `C-b`.\n\n## Configuration\n\n`nestmux` is configured with a json file located at `~/.config/nestmux/nestmux.json`. The default configuration is\n\n```\n{\n\t\"prefixes\": [\"C-h\", \"C-n\", \"C-b\"],\n\t\"socket_name\": \"NESTMUX\"\n}\n```\n\n`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.\n\n`socket_name` is the name of the `tmux` socket. There's rarely a point in setting this to anything other than the default.\n\n## Things to fix\n\n- 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.\n\n- Add a video to the README.\n\n- Change to TOML for config\n\n- Nicer error messages.\n\n- Command to validate config.\n\n- Command to show config.\n",
"bugtrack_url": null,
"license": "",
"summary": "Run nested tmux sessions with ease",
"version": "0.1.4",
"project_urls": {
"Homepage": "https://github.com/oivvio/nestmux",
"Repository": "https://github.com/oivvio/nestmux"
},
"split_keywords": [
"tmux",
"cli"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d1e2d645a8ac0614465267e8359c5cea179332d08d301378ed46d41980639294",
"md5": "8bb2468de0d0493ad8ad878bed53e573",
"sha256": "25ed9ccfb993342d17c2133b98f68a4c68d8af61e480fac9a45d4afa8c5005c3"
},
"downloads": -1,
"filename": "nestmux-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8bb2468de0d0493ad8ad878bed53e573",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 4993,
"upload_time": "2023-12-06T20:51:11",
"upload_time_iso_8601": "2023-12-06T20:51:11.844494Z",
"url": "https://files.pythonhosted.org/packages/d1/e2/d645a8ac0614465267e8359c5cea179332d08d301378ed46d41980639294/nestmux-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b3a504bf3a3a5e83cc82871ed436c3bba4c75890b11f657bb3da15447ed2e4c6",
"md5": "0da3fe7d53cd0dfa5578ffaf566a98d7",
"sha256": "934508ca2a3611a31e751df44b63d1d10ea09d9a3f826e0e18c52e16773ca012"
},
"downloads": -1,
"filename": "nestmux-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "0da3fe7d53cd0dfa5578ffaf566a98d7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 3928,
"upload_time": "2023-12-06T20:51:14",
"upload_time_iso_8601": "2023-12-06T20:51:14.529922Z",
"url": "https://files.pythonhosted.org/packages/b3/a5/04bf3a3a5e83cc82871ed436c3bba4c75890b11f657bb3da15447ed2e4c6/nestmux-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-06 20:51:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "oivvio",
"github_project": "nestmux",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "nestmux"
}
JSON
