Moonglow Quick Start Guide

Overview

The main script to run is mgfind. You must specify a plugin class using the -plugin option. The config/client.properties file allows use to specify default paramters for convenience, and comes with some examples of appropriate values to use. Arguments to the mgfind script are specified using the format: -x y. Arguments that are specific to the plugin are specified using the format: --x y.

Running The App

From the command-line, run mgfind, using the following arguments:

-plugin	The plugin class. The following plugins come with the distribution: org.silvermoon.moonglow.plugin.google.GooglePlugin, org.silvermoon.moonglow.plugin.amazon.AmazonPlugin, or org.silvermoon.moonglow.plugin.mozilla.MozillaPlugin
-format	The format template to use for the results. For example, specifying html will use the $MOONGLOW_HOME/templates/html.vm template, etc. Other good values are text, and csv. To customize your own template, simply create a file in the templates directory, e.g. bob.vm, and use -format bob.
-formatter	The class of the results formatter. Default is Velocity, so you'll probably not have a need to set this unless you wish to use a custom formatter.
-? or -help	Display usage message

Plugin Parameters

Each plugin will require certain parameters to be set. Specifying the --help option will display the plugin's usage, for example: mgfind -plugin org.silvermoon.moonglow.plugin.google.GooglePlugin --help

If this seems like a lot to type, open the file config/client.properties, where you can specify a default value by setting the console.plugin property. In that file you can also specify default parameters for each plugin, for example: amazon.keyword=forklifts

Examples

• Simple search: mgfind -plugin org.silvermoon.moonglow.plugin.amazon.AmazonPlugin --keyword "pimento loaves" --devtag your_tag
• View search results as a web page, show up to 30 results: mgfind -plugin org.silvermoon.moonglow.plugin.google.GooglePlugin -format google.html -max 30 --keyword aardvarks --devtag your_tag | lynx -stdin

  (in Windows:) mgfind ... > %MOONGLOW_HOME%/logs/result.html
  start iexplore %MOONGLOW_HOME%/logs/result.html

• Search google using the Mozilla plugin: mgfind -plugin org.silvermoon.moonglow.plugin.mozilla.MozillaPlugin --src http://www.google.com/mozilla/google.src --q "pickled advocados" (or, try, file:///... for a local .src file)
• Search Amazon at 1:30PM, send the results to your email address: echo 'mgfind -plugin org.silvermoon.moonglow.plugin.amazon.AmazonPlugin -format html --keyword "tofurkey" --devtag your_tag --tag your_associates_tag | mail -s "Amazon Results" foo@bar.com' | at 13:30