File	Date	Author	Commit
bash	2009-08-24	Grant McLean	[52e7bb] implement a bash_completion recipe
bin	2012-07-25	Grant McLean	[e4b24f] disable warnings - they can't all be fixed unde...
debian	2009-08-24	Grant McLean	[52e7bb] implement a bash_completion recipe
lib	2012-07-25	Grant McLean	[49b540] fix backup copy of config under Ruby 1.9
misc	2010-10-10	Grant McLean	[b90648] Merge branch 'master' of git://sshmenu.git.sour...
test	2007-10-13	Grant McLean	[ef0b71] - build_ui() no longer takes an argument
.gitignore	2009-08-15	Grant McLean	[684990] ignore release tarballs and the .deb build dire...
.irbrc	2007-09-29	Grant McLean	[7c66ab] - fix up library path in .irbrc
Changes	2009-08-24	Grant McLean	[58f233] for 3.18 release
License.txt	2009-08-16	Grant McLean	[9aea72] Update copyright year and license link
Makefile	2009-08-24	Grant McLean	[52e7bb] implement a bash_completion recipe
Makefile.dist	2009-08-24	Grant McLean	[52e7bb] implement a bash_completion recipe
README	2009-08-16	Grant McLean	[9aea72] Update copyright year and license link
TODO	2010-10-10	Grant McLean	[b90648] Merge branch 'master' of git://sshmenu.git.sour...
gnome-sshmenu-applet.png	2005-09-28	Grant McLean	[00449e] Replaced Perl version and support files with Ru...
make-debs.pl	2009-01-15	Grant McLean	[a4f5dd] - script to build .debs from release tarball
sshmenu-applet	2009-08-16	Grant McLean	[9aea72] Update copyright year and license link
sshmenu-applet.server	2006-06-28	Grant McLean	[0e39e8] - renamed panel applet wrapper
sshmenu.1	2009-08-24	Grant McLean	[87810e] document the --list-completions option
wizard-icon.png	2006-06-09	Grant McLean	[5951ec] - initial check-in

Read Me

DESCRIPTION

  sshmenu-applet is a GNOME panel applet for connecting to hosts using SSH.
  It can also be run as a standalone application without GNOME dependencies.

  sshmenu-applet puts all your most frequently used SSH connections on a handy
  menu in your GNOME panel.  Click on a host name to open a new gnome-terminal
  window with an ssh connection to the selected host.  Set up SSH options (such
  as port forwarding etc) and select a gnome terminal profile (for colour
  schemes, font sizes etc) using the preferences dialog.

  The application is implemented as a set of Ruby classes so you should be able
  to hack it to work in contexts other than the GNOME panel (e.g.: a standalone
  menu button; swallowed into the panel of another window manager; or embedded
  into your own Ruby-GTK application).


DEPENDENCIES

  sshmenu-applet is a Ruby script which uses the following ruby library
  packages (on Debian):

    libgtk2-ruby libpanel-applet2-ruby libgconf2-ruby

  You should also have an ssh-agent running and have either x11-ssh-askpass
  or gnome-ssh-askpass installed.


INSTALLATION

  The simplest way to install the sshmenu-applet is to install the Debian
  packages.  Of course if you're not running Debian then that might not be
  so simple.

  The files from the distribution should be installed as follows:

  lib/sshmenu.rb - a Ruby library that implements the standalone SSHMenu UI
    (without GNOME dependencies).  It should be installed in a standard Ruby
    library directory, e.g.: /usr/lib/ruby/1.8/sshmenu.rb

  lib/gnome-sshmenu.rb - a Ruby library that adds the GNOME-specific features
    to SSHMenu.  It should also be installed in a standard Ruby library
    directory.

  sshmenu-applet - a small wrapper script that uses sshmenu.rb to create
    an instance of the application in a panel applet window.  It can be 
    installed anywhere as long as the path in the .server file (see below)
    is adjusted to point to it.  Typical location:
    /usr/lib/gnome-panel/sshmenu-applet

  gnome-sshmenu-applet.png - an icon used to represent the applet in the 
    GNOME panel applet selector dialog ("Add to Panel").  It must be 
    installed wherever your GNOME installation expects to find applet icons.
    Typical location:
    /usr/share/icons/hicolor/48x48/apps/gnome-sshmenu-applet.png

  sshmenu-applet.server - file used to register the applet so that it can be
    found and started by GNOME.  It must be adjusted to include the full
    pathname of where you installed sshmenu-applet.rb and would typically
    be installed as:
    /usr/lib/bonobo/servers/sshmenu-applet.server

  bin/sshmenu - a short wrapper script which implements the menu using the
    sshmenu.rb library. This file should go in /usr/bin and must be
    executable. (Not required at all for running the panel applet).

  bin/sshmenu-gnome - a short wrapper script implements the standalone menu
    with GNOME-specific functionality. It should live in the same directory
    as sshmenu (above) and should also be executable.  (Also not required for
    running the panel applet).

  For more information, see the installation and packaging guide:

    http://sshmenu.sourceforge.net/download/install.html


CUSTOMISATION

  A user would typically customise the list of hosts which appear on the menu
  using the preferences dialog.  More complex customisations can be achieved
  using techniques described in the Hacker's Guide:

    http://sshmenu.sourceforge.net/dev/hackers_guide.html


COPYRIGHT

  Copyright 2002-2009 Grant McLean <grant@mclean.net.nz>

  This package is free software; you can redistribute it and/or modify it
  under the terms of the License.txt file (a BSD-style license) distributed 
  with the software.