# &app; Manual V&manrevision;

## Introduction

The &app; application enables you to search for files on your system. To perform a basic search, you can type a filename or a partial filename with wildcards. To refine your search, you can select additional search options that you want &app; to apply.

&app; uses the `find`, `grep`, and `locate` UNIX commands.

## Getting Started

You can start &app; in the following ways:

Actions menu

- Choose Search for Files.

Command line

- Type `gnome-search-tool`, then press Return.

When you start &app;, the following window is displayed.

### &app; Window

Shows &app; main window.

## Usage

### To Perform a Basic Search

To perform a basic search for a file on the system, perform the following steps:

1. In the Name Contains field, enter the following:

   - A string, for example `myfile`. &app; searches the filesystem for all filenames that contain the string `myfile`.

   - A string combined with wildcards (* or ?), for example `*.txt`. &app; searches the filesystem for all files with the extension `.txt`.

2. In the Look in folder field enter the path to the folder in which you want &app; to begin the search. &app; searches in the folder that you specify and the subfolder of the folder.

3. Click Find to perform the search. &app; displays the results of the search in the Search results list box. If &app; does not find any files that match the search criteria, the application displays the message "No Files Found" in the Search results list box.

### To Add Search Options

To add search options to search for a file on the system, perform the following steps:

1. Click on Show more options.

2. Click the Available options drop-down list box.

3. Select the search option that you want to apply.

4. Click Add to add the search option to the list of additional options.

5. Specify the required search information for the search rule, see tbl-search-rules for information.

6. Repeat the above steps for each search option that you want to apply.

To remove a search option from the Show more options list, click on the Remove button next to the option.

### Search Rules

Rule Name | Description
Contains the text | Search for files that contain specific text. The search is case insensitive on most systems.
Date modified less than (days) | Search for files that were modified in the period less than the number of days specified.
Date modified more than (days) | Search for files that were modified in the period more than the number of days specified.
Size at least (kilobytes) | Search for files that are larger than the size specified.
Size at most (kilobytes) | Search for files that are less than the size specified.
File is empty | Search for empty files.
Owned by user | Search for files that are owned by the user specified. Type the name of the user in the text box provided.
Owned by group | Search for files that are owned by the group specified. Type the name of the group in the text box provided.
Owner is unrecognized | Search for files that are owned by a user or group that is unknown to the system.
Name does not contain | Search for files with names that do not contain the text that you enter. Wildcards are supported in the field provided. Use * to indicate a sequence of characters. Use ? to indicate a single character. The search is case insensitive on most systems.
Name matches regular expression | Search for files that contain the specified regular expression in their directory path or filename. Type the regular expression in the text box provided.
Show hidden files and folders | Search includes hidden files and folders. A file or folder is hidden if its name begins with a dot (.) character.
Follow symbolic links | Follow symbolic links when searching for files.
Include other filesystems | Search includes folders that are not on the same filesystem as the start folder.

### To Stop a Search

Click Stop to stop a search before &app; completes the search.

### To Open a File Found

To open a file displayed in the Search results list box, perform one of the following steps:

- Right-click on the file, then choose Open.

- Double-click on the file.

To open the folder that contains a file displayed in the Search results list box, right-click on the file, then choose Open Folder.

To copy a file displayed in the Search results list box to another area on the desktop, drag the file to the area.

### To Save the Search Results

To save the results of the last search that &app; performed, right-click in the Search results list, then choose Save Results As. Enter the name of the file to which you want to save the results, then click OK.