Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Updated README file

  • Loading branch information...
commit fb04eb1198bd524e267d0e784f19535b4f03e814 1 parent 554415f
@aluzzardi authored
Showing with 46 additions and 0 deletions.
  1. +46 −0 README.md
View
46 README.md
@@ -8,3 +8,49 @@ at the bridge level and the pty is wrapper through a thin layer of JSON and sent
This means you can implement a WSSH client in just a few lines of code, even for a web browser.
+Usage
+-----
+
+Even though `wssh` primary purpose is to be used as a library in your applications,
+it ships with two command line tools: `wsshd` (the server) and `wssh` (the client).
+
+```
+$ wsshd
+wsshd/0.1.0 running on 0.0.0.0:5000
+```
+
+```
+$ wssh aluzzardi@mba -p
+Password:
+Last login: Mon Jul 23 23:20:27 2012 from localhost
+aluzzardi@mba:~$
+```
+
+Web Interface
+-------------
+
+wsshd provides a web interface giving you access to a Javascript client
+
+![wssh: shell](https://github.com/aluzzardi/wssh/raw/master/misc/shell_screenshot.png)
+
+![wssh: vim](https://github.com/aluzzardi/wssh/raw/master/misc/vim_screenshot.png)
+
+Creating your own server
+------------------------
+
+`wsshd` is just a simple server implementation to demonstrate the wssh library.
+
+You can actually integrate wssh into your own Python web application in order to provide terminal access.
+For instance, you may want to provide shell access to clients authenticated through OAuth to a special user account.
+The client doesn't need to know where the SSH server is located nor its credentials.
+
+An example using the Flask framework is provided in `examples/flask_server.py`
+
+Creating your own client
+------------------------
+
+Beside the command line tool, `wssh` comes bundled with both a Python and a Javascript client library for the wssh bridge.
+
+There are examples available in the `examples/` directory for both languages.
+
+You can write your own library in another language in just a few lines of code.
Please sign in to comment.
Something went wrong with that request. Please try again.