
              NS-CLI -- a commandline interface for Netscape
                    Rich Lafferty <rich@lafferty.ca>


This program allows you to use Netscape or Mozilla's location bar to
tell Netscape to perform searches and access similar Web resources. 
For example, typing "find cold beans" into the Location bar will
take you to the results of a Google search for "cold beans". Typing
"help me" will give you a list of possible commands.


Configuring the browser:

1) Netscape 4.xx (Unix):

   Put something like
     user_pref("network.search.url", "http://your.host/ns-cli.cgi?");
   in "~/.netscape/preferences.js". (Note the trailing "?" in the argument.)

2) Netscape 6/Mozilla (Unix):

   Put something like
     user_pref("keyword.URL", "http://your.host/ns-cli.cgi?");
   in "~/.mozilla/$USER/*/user.js". (Note trailing "?").

If you use Windows or Mac OS, please let me know how to reference this
in your configuration files.

Be sure to turn on "Internet Keywords" in the Smart Browsing section
of your Netscape/Mozilla prefs.


How this works/Extending:

Netscape needs two words in the location bar else it just tries to
find "www._____.com". The first word here is a command, which matches
a key in the %search array in ns-cli.conf, in which case we redirect
to the value associated with that key (with the rest of the location
bar in %%QUERY%%.  If we don't match, then we use the key which is the
value associated with the key 'default'.

For example, with
      find    => 'http://www.google.com/search?query=%%QUERY%%'
we can type "find cold beans" into Netscape's location bar, and get
back the results of a Google search for "cold beans".


LICENSE

This is free software with ABSOLUTELY NO WARRANTY. This program is
released under the same terms as Perl itself (specifically, under your
choice of either the GNU Public License version 2, or the Perl
Artistic License).


Thanks to Stefan `Sec` Zehl for the pointer about that NS preference.

SEND ME <rich+nscli@lafferty.ca> YOUR USEFUL SEARCHES! :-)
