Metadata-Version: 2.1
Name: master-ssh
Version: 2.0.4
Summary: Tool to connect to multiple SSH servers and broadcast commands.
Home-page: https://github.com/JaanPorkon/master-ssh
Author: Jaan Porkon
Author-email: jaantrill@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: paramiko
Requires-Dist: configparser
Requires-Dist: termcolor

###### Introduction
It's a little tool that allows you to connect to multiple SSH tunnels at the same time and broadcast commands instantly.

###### Installation

```
pip install master-ssh
```

Or clone from Github:

```
git clone https://github.com/JaanPorkon/master-ssh.git
cd master-ssh
python setup.py install
```

###### Usage

To run the program you can feed credentials to it from URL or from a file. Source of the web page and file must be in CSV format:

```
hostname,127.0.0.1,username,password
hostname2,127.0.0.2,username,password
```

**Getting credentials:**

```
master-ssh --cred-file /path/to/credentials.txt
```

or

```
master-ssh --cred-url https://mydomain.tld/credentials
```

or if you wish to connect to specific servers:

```
master-ssh --cred-url https://mydomain.tld/credentials --servers hostname,hostname2,...
```

**Connecting to servers:**

To send command to 1 server only use the following command pattern:

_#[hostname] [command]_

**Examples:**

To see all available internal commands write:

```
master-ssh$ #help
```

or just:

```
master-ssh$ #
```

If you wish to send your command to only 1 specific server, use the following command:

```
master-ssh$ #hostname uname -a
```

If you wish to send commands to more than 1 specific server just separate them with commas like this:

```
master-ssh$ #hostname,hostname2 uname -a
```

If you want to ignore specific servers from your server list, use the following command:

```
master-ssh$ #ignore:hostname,hostname2 uname -a
```

If you wish to close the program, simply write exit:

```
master-ssh$ exit
```

