https://github.com/pearl-hub/tmux-multi
Run commands over multiple Tmux panes/windows
https://github.com/pearl-hub/tmux-multi
bash cli commands tmux
Last synced: 2 months ago
JSON representation
Run commands over multiple Tmux panes/windows
- Host: GitHub
- URL: https://github.com/pearl-hub/tmux-multi
- Owner: pearl-hub
- License: gpl-3.0
- Created: 2017-06-24T11:14:06.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2020-01-31T18:30:47.000Z (over 6 years ago)
- Last Synced: 2025-10-29T08:38:06.979Z (8 months ago)
- Topics: bash, cli, commands, tmux
- Language: Shell
- Size: 29.3 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
TMUX-MULTI
==========
|Project Status|Communication|
|:-----------:|:-----------:|
|[](https://travis-ci.org/pearl-hub/tmux-multi) | [](https://gitter.im/pearl-core/pearl?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |
**Table of Contents**
- [Description](#description)
- [Quickstart](#quickstart)
- [Installation](#installation)
- [Troubleshooting](#troubleshooting)
Description
===========
- name: `tmux-multi`
- description: Run commands over multiple Tmux panes/windows
- author: Filippo Squillace
- username: fsquillace
- OS compatibility: linux, osx
Quickstart
==========
Given a list of commands from stdin, `tmux-multi` allows to
create multiple Tmux panes for each command:
```sh
echo -e "top\nbash\nssh localhost" | tmux-multi
```
If the number of panes generated exceeds the maximum value
(default 6), `tmux-multi` will create a new window instead.
The Tmux pane containing short lived programs (i.e. `ls`)
will close immediately and you will not be able to see the result.
For this, it is recommended to use the option `--keep-panes`,
for instance:
```sh
echo -e "ls -l\ntop" | tmux-multi --keep-panes
```
Alternatively, you can combine the command you want to run with the handy `watch` command:
```sh
echo -e "watch ls -l\ntop" | tmux-multi
```
To know all `tmux-multi` options: `tmux-multi --help`
Installation
============
This package needs to be installed via [Pearl](https://github.com/pearl-core/pearl) system.
```sh
pearl install tmux-multi
```
Dependencies
------------
The main dependencies are the following:
- [Pearl](https://github.com/pearl-core/pearl)
- [GNU coreutils](https://www.gnu.org/software/coreutils/)
Troubleshooting
===============
This section has been left blank intentionally.
It will be filled up as soon as troubles come in!