sshmenu icon indicating copy to clipboard operation
sshmenu copied to clipboard

sshmenu

sshmenu is a simple tool for connecting to remote hosts via ssh. Great if you have trouble remembering ip addresses, hostnames, or usernames.

This tool works by using Python's os.execvp(...), which will replace the current process (python) with ssh to create a seamless transition.

.. image:: https://i.imgur.com/LGrrENa.gif

Quick Setup

Tested working on macOS High Sierra (10.13.1) and Ubuntu Trusty Tahr (14.04), Xenial Xerus (16.04)

macOS

.. code-block:: bash

brew install https://raw.githubusercontent.com/mmeyer724/sshmenu/master/sshmenu.rb sshmenu

Linux

.. code-block:: bash

pip3 install sshmenu sshmenu

Development

.. code-block:: bash

git clone https://github.com/mmeyer724/sshmenu.git cd sshmenu pip3 install -r requirements.txt python3 -m sshmenu

Configuration

On first run an example configuration file will be created for you, along with the path. For reference, I've added this information here as well.

OS X

.. code-block:: bash

nano ~/Library/Application\ Support/sshmenu/config.json

Linux

.. code-block:: bash

nano ~/.config/sshmenu/config.json

Default contents

.. code-block:: json

{
    "targets": [
        {
            "host": "[email protected]",
            "friendly": "This is an example target",
            "options": []
        },
        {
            "command": "mosh",
            "host": "[email protected]",
            "friendly": "This is an example target using mosh",
            "options": []
        }
    ]
}

You can specify additional command line options (see man ssh) as follows:

.. code-block:: json

{
    "targets": [
        {
            "host": "[email protected]",
            "friendly": "An example target listening non-standard port and verbose flag", 
            "options" : [
                "-p443",
                "-v"
            ]
        }
    ]
}

Todo

  • Automatically ask to place your ~/.ssh/id_rsa.pub into the remote host's ~/.ssh/authorized_keys