# &applet; Applet Manual

## Introduction

The &applet; Applet can be loaded with specific extensions that allow the user to easily and quickly search various search engines and websites, lookup words in the dictionary, search for files on the computer, or run programs, among other things.

## Adding &applet; to the panel

To add &applet; to a panel:

1. Right-click on the panel to open the panel popup menu, then choose Add to Panel .

2. Select &applet; in the Add to Panel dialog, then click Add.

   Alternatively, just drag the applet from the dialog to a location on the panel.

For more information on adding applets to a panel, see the GNOME User Guide.

## Activating &applet;

To activate &applet;, press the &applet; icon on the panel (see the picture below).

Shows the &applet; applet.

Alternatively, press Alt F3 to activate &applet;.

### Sticking the search box to the panel

By default, activating &applet; will open a new window with a search box in it. If you would prefer the search box to remain attached to the panel when you activate &applet;:

1. Right-click the &applet; icon on the panel and select Preferences.

2. Select the General tab and click Stick to panel.

### Changing the keyboard shortcut

You can change the keyboard shortcut used to activate &applet;:

1. Right-click the &applet; icon on the panel and select Preferences.

2. Select the General tab.

3. Click the text entry labelled Keyboard shortcut to focus. The text should change to say New accelerator...

4. Type the new keyboard shortcut that you would like to use. The change will take effect immediately.

To cancel editing the keyboard shortcut, click anywhere outside the text entry or press Escape.

## Searching for items

### Performing a search

1. Activate &applet; and type some search terms into the search box.

2. &applet; will recommend some items depending on the search terms you entered.

3. Click the item of your choice. &applet; will perform the appropriate action for that item; for example, clicking a web link will cause it to be opened in your web browser.

Some search results have more than one possible action. In this case, a > is displayed to the right of the item. When you click on the > you will get a list of available actions.

### Enabling and disabling search extensions

You can enable and disable search extensions in order to change what types of search are displayed in the search results. For example, you might wish to enable the Dictionary extension so that you can look up word definitions using Deskbar.

1. Right-click the &applet; icon on the panel and select Preferences.

2. Select the Searches tab.

3. To enable a search extension, select it from the list. To disable a search extension, deselect it.

For some search extensions you can click More... to set additional settings.

### Changing the order of search extensions

You can change the order of the search extensions, so that types of search which are more important to you are displayed at the start of the search results.

1. Right-click the &applet; icon on the panel and select Preferences.

2. Select the Searches tab.

3. Select the search extension, then click Top, Up, Down or Bottom to change the search extension's order.

   Alternatively, drag and drop the search extensions to change their order.

### Extensions with errors

If an extension does not appear in the search results as expected, there may be a problem with it.

1. Right-click the &applet; icon on the panel and select Preferences.

2. Select the Extensions with Errors tab.

3. To see the reason for an error, select the affected extension from the list. Information on the error will be shown below the list.

## Search history

### Using the history

The search history is a list of searches which you have made before. Instead of inputting the same search terms again, you can select a previous search from the history.

1. Activate &applet;.

2. Click Choose action and select a previous search from the list.

3. The search you selected will be performed again.

### Clearing the history

Sometimes you may want to clear your search history. There are two ways of achieving this:

- Activate &applet; and click the Clear button to the right of the Choose action drop-down list.

- Right-click the &applet; icon on the panel and select Clear History.

## Installing new extensions

You can install new search extensions for &applet;.

Drag and drop a search extension onto the Preferences dialog to install it. This works with `.py`, `.tar.gz`, `.tar.bz2`, `.tar` and `.zip` files.

Alternatively, you can drag and drop an URL from your web browser onto the Preferences dialog. The file will be downloaded and installed automatically.

## About &applet;

&applet; was written by Nigel Tao (nigel.tao@myrealbox.com), Raphael Slinckx (raphael@slinckx.net), Mikkel Kamstrup Erlandsen (kamstrup@daimi.au.dk), Sebastian Pölsterl (marduk@k-d-w.org). To find more information about &applet;, please visit the &applet; Web page.

To report a bug or make a suggestion regarding this application or this manual, follow the directions in the Feedback section of the GNOME User Guide.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license is included with this documentation; another can be found in the file COPYING included with the source code of this program.