https://github.com/DevDungeon/issh

Improved SSH: Curses TUI to select SSH connection from ~/.ssh/config file
https://github.com/DevDungeon/issh

Last synced: about 2 months ago
JSON representation

Improved SSH: Curses TUI to select SSH connection from ~/.ssh/config file

• Host: GitHub
• URL: https://github.com/DevDungeon/issh
• Owner: DevDungeon
• Created: 2019-05-31T21:45:36.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-03-31T14:47:58.000Z (over 1 year ago)
• Last Synced: 2024-09-23T04:18:45.645Z (3 months ago)
• Language: Python
• Size: 27.3 KB
• Stars: 25
• Watchers: 2
• Forks: 9
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome - issh

README

        
# issh

[![PyPI version](https://badge.fury.io/py/issh.svg)](https://pypi.org/project/issh/)

Improved SSH launcher that provides a browsable

menu of SSH servers. Uses `~/.ssh/config`

to generate menu.

For more tips on using SSH and the configuration file, check out [https://www.devdungeon.com/content/ssh-tips](https://www.devdungeon.com/content/ssh-tips)

![Works in Windows, Mac, Linux](screenshots/screenshot1.png)

## Install

Install from pypi.org using:

```bash

python -m pip install issh

```

Install from source by running this from

the root of the source code directory:

```bash

python setup.py install

```

## Usage

Simply run `issh` from the command line to launch

the menu.

```bash

issh

```

Or invoke via Python:

```bash

python -m issh

```

To use the tool inside PYthon source code:

```python

from issh import ISSH

issh = ISSH()

issh.run()

```

## Controls

- `Esc` or `q`: Quit

- `Enter`, `l`, or `Right Arrow`: Connect

- `j` or `Down Arrow`: Down

- `k` or `Up Arrow`: Up

- `e`: Edit SSH config file

When using the Edit (`e`) command, it tries to use

the editor defined in `EDITOR` environment variable,

otherwise attempts to default to a system editor. 

## Troubleshooting

If you have permission errors with the `~/.ssh/config` file,

make sure the `.ssh/` directory has `700` permissions and

the `config` file has `600` permissions. Also ensure

the owner is correct.

## Source code

[https://github.com/DevDungeon/issh](https://github.com/DevDungeon/issh)

## Author

NanoDano 

## To do

- On right, show the config details