missh 0.3.1

Minimalist Session Manager for SSH/SFTP

Welcome to

Minimalist Session Manager for SSH/SFTP
***************************************

Design
======

* store session information in .msh files, including various ssh cmdline options
* use a password keeping service to store encrypted passwords in ~/.missh

Platforms
=========

MiSSH is written in Python 2.7. It should work well on most POSIX platforms.
I have tested it on Mac OSX, Linux and Cygwin.

Install
=======

please use easy_install_ to install missh::

sudo easy_install missh

Upgrade::

sudo easy_install -U missh

.. _easy_install: https://pypi.python.org/pypi/setuptools

Command line
============

missh [opt] [file_path]
-o open the session file
-n create a new session file
-m change the master password
-t timeout change the timeout of caching the master password, in minutes
-k kill the background password keeping service
-r reconnect automatically after disconnection
-f use sftp to connect the host
-h show the help information
-v verbose mode

.. * \-C file use file as the configuration

Notice
======

Please **DO NOT** change the term size **AFTER** login, otherwise the term might get stuck.
If it got stuck, you need to log out and log in again.
This is a problem of the term, not MiSSH :)

Examples
========

* missh host.msh
* missh -o host.msh
* missh -n new_host.msh
* missh -f host.msh
* missh -m
* missh -t 120

.. * missh -C myssh.conf my_host.msh
* ./my_host.msh # when missh is in the correct path
* ./my_host.msh -C myssh.conf

Screen shots
============

Open or create a seesion file::

┌ MiSSH - test.msh ────────────────────────────────────────────────────────────┐
│ │
│ Host: [e-mail]:22 │
│ Password: --- │
│ Other options: │
│ │
│ % set dynamic socks proxy │
│ -D 1080 │
│ │
│ % forward a local port to a service at a remote port, e.g. vnc @ host:1 │
│ % -L 5901 │
│ % -L 5901:1.2.3.4:5901 │
│ │
│ % forward a remote port to a service at a local port │
│ % -R 8080 │
│ │
│ % sftp options use # as the line header │
│ # -r │
│ │
│ │
│ Cancel OK │
└──────────────────────────────────────────────────────────────────────────────┘

.. Edit the configuration::

Session file format
================

* host = user\@host:port
* # there might be multiple lines of opt:
* opt = -D 1080
* opt = -L 5901
* opt = -R 8080

Configuration file format
=========================

* timeout = 120
* master = NONCE,mi_hash(master_key)
* host_sha256 = NONCE,key_encrypted_using_master1024_key_under_aes

License
=======

BSD 2-Clause License at https://github.com/LenxWei/MiSSH/blob/master/COPYING