ACC SHELL
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 6. Searching with Beagle</title><link rel="stylesheet" href="susebooks.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Documentation"><link rel="up" href="part.gnome.manage.html" title="Part II. Internet Connectivity, Files and Resources"><link rel="prev" href="cha.gnome.network.html" title="Chapter 5. Accessing Network Resources"><link rel="next" href="cha.gnome.print.html" title="Chapter 7. Managing Printers"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" border="0" class="bctable"><tr><td width="80%"><div class="breadcrumbs"><p><a href="index.html"> Documentation</a><span class="breadcrumbs-sep"> > </span><a href="book.gnomeuser.html">GNOME User Guide</a><span class="breadcrumbs-sep"> > </span><a href="part.gnome.manage.html">Internet Connectivity, Files and Resources</a><span class="breadcrumbs-sep"> > </span><strong><a accesskey="p" title="Chapter 5. Accessing Network Resources" href="cha.gnome.network.html"><span>◀</span></a> <a accesskey="n" title="Chapter 7. Managing Printers" href="cha.gnome.print.html"><span>▶</span></a></strong></p></div></td></tr></table></div><div class="chapter" title="Chapter 6. Searching with Beagle"><div class="titlepage"><div><div><h2 class="title"><a name="cha.gnome.beagle"></a>Chapter 6. Searching with Beagle<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#cha.gnome.beagle">¶</a></span></h2></div></div></div><div class="toc"><p><b>Contents</b></p><dl><dt><span class="sect1"><a href="cha.gnome.beagle.html#sec.gnome.beagle.use">6.1. Using Beagle</a></span></dt><dt><span class="sect1"><a href="cha.gnome.beagle.html#sec.gnome.beagle.tipps">6.2. Search Tips</a></span></dt><dt><span class="sect1"><a href="cha.gnome.beagle.html#sec.gnome.beagle.property_search">6.3. Performing a Property Search</a></span></dt><dt><span class="sect1"><a href="cha.gnome.beagle.html#sec.gnome.beagle.prefs">6.4. Setting Search Preferences</a></span></dt><dt><span class="sect1"><a href="cha.gnome.beagle.html#sec.gnome.beagle.indexing">6.5. Indexing Other Directories</a></span></dt><dt><span class="sect1"><a href="cha.gnome.beagle.html#sec.gnome.beagle.indexing_exclude">6.6. Preventing Files and Directories from Being Indexed</a></span></dt><dt><span class="sect1"><a href="cha.gnome.beagle.html#id405887">6.7. Selecting Data Sources to Index</a></span></dt><dt><span class="sect1"><a href="cha.gnome.beagle.html#id405969">6.8. Disabling Beagle</a></span></dt><dt><span class="sect1"><a href="cha.gnome.beagle.html#sec.gnome.beagle.more">6.9. For More Information</a></span></dt></dl></div><p>
Beagle is a search tool that indexes your personal information space
(normally your home directory) in order to carry out search requests.
Using Beagle, you can find documents, e-mails and attachments, Web
history, IM/IRC conversations, address book contacts, calendar
appointments, notes, source code, images, music (and video) files,
archives (and their contents) and applications.
</p><div class="sect1" title="6.1. Using Beagle"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.gnome.beagle.use"></a>6.1. Using Beagle<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.gnome.beagle.use">¶</a></span></h2></div></div></div><p>
To use Beagle, click <span class="guimenu">Computer</span>, enter your search terms in the <span class="guimenu">Search</span>
field, then press <span class="keycap">Enter</span>. The results are displayed in
the Desktop Search dialog box.
</p><div class="figure"><a name="id415193"></a><p class="title"><b>Figure 6.1. Desktop Search Dialog Box</b></p><div class="figure-contents"><div class="mediaobject"><table border="0" summary="manufactured viewport for HTML img" cellspacing="0" cellpadding="0" width="80%"><tr><td><img src="images/beagle_search.png" width="100%" alt="Desktop Search Dialog Box"></td></tr></table></div></div></div><br class="figure-break"><p>
You can use the results lists to open a file, forward it via e-mail, move
it to trash, or display it in the file manager. Simply right-click an
item in the results list and select desired option. The options available
for an item in the results list are determined by its filetype. Selecting
a file in the list displays a preview of the file and information such as
the title, path, and date the file was last accessed or modified.
</p><div class="figure"><a name="id415244"></a><p class="title"><b>Figure 6.2. Desktop Search Dialog Box With a File Selected</b></p><div class="figure-contents"><div class="mediaobject"><table border="0" summary="manufactured viewport for HTML img" cellspacing="0" cellpadding="0" width="80%"><tr><td><img src="images/beagle_display.png" width="100%" alt="Desktop Search Dialog Box With a File Selected"></td></tr></table></div></div></div><br class="figure-break"><p>
Use the <span class="guimenu">Find In</span> menu to limit your search to sources
of a specific type (such as applications, documents, pictures, emails,
web pages or contacts). The <span class="guimenu">View</span> menu lets you sort
the items in your results list according to name, relevance or the date
the file was last modified.
</p><p>
You can also access Desktop Search by clicking <span class="guimenu">Computer</span>+<span class="guimenu">More Applications</span>+<span class="guimenu">System</span>+<span class="guimenu">Search</span> or
start it from a terminal using the <span class="command"><strong>beagle-search</strong></span>.
</p></div><div class="sect1" title="6.2. Search Tips"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.gnome.beagle.tipps"></a>6.2. Search Tips<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.gnome.beagle.tipps">¶</a></span></h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="bullet"><li class="listitem" style="list-style-type: disc"><p>
You can use both uppercase and lowercase letters in search terms.
Searches are not case-sensitive.
</p></li><li class="listitem" style="list-style-type: disc"><p>
To search for optional terms, use <code class="literal">OR</code> (for example,
<code class="literal">apples OR oranges</code>).
</p><div class="important"><table border="0" cellpadding="3" cellspacing="0" width="100%" summary="Important"><tr class="head"><td width="32"><img alt="[Important]" src="admon/important.png"></td><th align="left"></th></tr><tr><td colspan="2" align="left" valign="top"><p>
The <code class="literal">OR</code> has to be capitalized when used to indicate
optional search terms.
</p></td></tr></table></div></li><li class="listitem" style="list-style-type: disc"><p>
To exclude search terms, use a minus sign (<code class="literal">-</code>) in
front of the term you want to exclude (for example, <code class="literal">apples
-oranges</code> will find results containing apples but not
oranges).
</p></li><li class="listitem" style="list-style-type: disc"><p>
The root form of a search term is used when searching (for example, a
search for <code class="literal">driving</code> will match
<code class="literal">drive</code>, <code class="literal">drives</code>, and
<code class="literal">driven</code>).
</p></li><li class="listitem" style="list-style-type: disc"><p>
To search for an exact phrase or word, put quotation marks
(<code class="literal">""</code>) around the phrase or word.
</p></li><li class="listitem" style="list-style-type: disc"><p>
Common words such as "a”, “the” and “is” are ignored.
</p></li></ul></div></div><div class="sect1" title="6.3. Performing a Property Search"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.gnome.beagle.property_search"></a>6.3. Performing a Property Search<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.gnome.beagle.property_search">¶</a></span></h2></div></div></div><p>
By default, the Beagle search tool looks for search terms in the text of
documents and in their metadata. To search for a word in a particular
property, use
<span class="command"><strong><em class="replaceable"><code>property:</code></em><em class="replaceable"><code>query</code></em></strong></span>.
For example, <code class="literal">author:john</code> searches for files that have
“john” listed in the Author property.
</p><div class="table"><a name="id415460"></a><p class="title"><b>Table 6.1. Supported Property Keywords</b></p><div class="table-contents"><table summary="Supported Property Keywords" border="1"><colgroup><col><col><col></colgroup><thead><tr><th>
<p>
Keyword
</p>
</th><th>
<p>
Applies to
</p>
</th><th>
<p>
Property
</p>
</th></tr></thead><tbody><tr><td>
<p>
album
</p>
</td><td>
<p>
Music files
</p>
</td><td>
<p>
Name of album
</p>
</td></tr><tr><td>
<p>
artist
</p>
</td><td>
<p>
Music file
</p>
</td><td>
<p>
Name of artist
</p>
</td></tr><tr><td>
<p>
author
</p>
</td><td>
<p>
Document
</p>
</td><td>
<p>
Author of the document (same as Creator of the Document)
</p>
</td></tr><tr><td>
<p>
creator
</p>
</td><td>
<p>
Document
</p>
</td><td>
<p>
Creator of the document, mapped to dc:creator (for example, creator
of PDF files)
</p>
</td></tr><tr><td>
<p>
email
</p>
</td><td>
<p>
Address book
</p>
</td><td>
<p>
E-mail address
</p>
</td></tr><tr><td>
<p>
emblem
</p>
</td><td>
<p>
File
</p>
</td><td>
<p>
Emblem used in Nautilus
</p>
</td></tr><tr><td>
<p>
extension or ext
</p>
</td><td>
<p>
File
</p>
</td><td>
<p>
File extension (for example, extension:jpeg or ext:mp3). Use
extension: or ext: to search in files with no extension.
</p>
</td></tr><tr><td>
<p>
genre
</p>
</td><td>
<p>
Music file
</p>
</td><td>
<p>
Genre of music
</p>
</td></tr><tr><td>
<p>
imagecomment
</p>
</td><td>
<p>
Image file
</p>
</td><td>
<p>
Comments and descriptions found in images that have an IPTC caption
or Exif comment
</p>
</td></tr><tr><td>
<p>
imagemodel
</p>
</td><td>
<p>
JPEG image
</p>
</td><td>
<p>
Model of camera (for example, EOS2D)
</p>
</td></tr><tr><td>
<p>
imagetag
</p>
</td><td>
<p>
Image file
</p>
</td><td>
<p>
F-Spot and DigiKam image tags, and IPTC keywords
</p>
</td></tr><tr><td>
<p>
inarchive
</p>
</td><td>
<p>
File
</p>
</td><td>
<p>
Use <code class="literal">inarchive:true</code> for files inside an archive
</p>
</td></tr><tr><td>
<p>
inattachment
</p>
</td><td>
<p>
File
</p>
</td><td>
<p>
Use <code class="literal">inattachment:true</code> for email attachments.
</p>
</td></tr><tr><td>
<p>
mailfrom
</p>
</td><td>
<p>
E-mail
</p>
</td><td>
<p>
Name of sender
</p>
</td></tr><tr><td>
<p>
mailfromaddr
</p>
</td><td>
<p>
E-mail
</p>
</td><td>
<p>
E-mail address of sender
</p>
</td></tr><tr><td>
<p>
mailinglist
</p>
</td><td>
<p>
E-mail
</p>
</td><td>
<p>
Id of mailing list (for example, dashboard-hackers.gnome.org)
</p>
</td></tr><tr><td>
<p>
mailto
</p>
</td><td>
<p>
E-mail
</p>
</td><td>
<p>
Name of recipient
</p>
</td></tr><tr><td>
<p>
mailtoaddr
</p>
</td><td>
<p>
E-mail
</p>
</td><td>
<p>
E-mail address of recipient
</p>
</td></tr><tr><td>
<p>
speakingto
</p>
</td><td>
<p>
Chat
</p>
</td><td>
<p>
Speaker
</p>
</td></tr><tr><td>
<p>
title
</p>
</td><td>
<p>
Document
</p>
</td><td>
<p>
Title of document, mapped to dc:title (for example, title tag of
HTML files)
</p>
</td></tr></tbody></table></div></div><br class="table-break"><p>
Property searches follow the rules mentioned in
<a class="xref" href="cha.gnome.beagle.html#sec.gnome.beagle.tipps" title="6.2. Search Tips">Section 6.2, “Search Tips”</a>.
You can use property searches as an OR query or as an exclusion query,
and phrases can be used as <em class="replaceable"><code>query</code></em>. For example,
the following line will search for all PDF or HTML documents containing
the word “apple” whose author property contains “john” and whose
title does not contain the word “oranges”:
</p><p>
<code class="literal">apple ext:pdf OR ext:html author:john -title:oranges</code>
</p></div><div class="sect1" title="6.4. Setting Search Preferences"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.gnome.beagle.prefs"></a>6.4. Setting Search Preferences<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.gnome.beagle.prefs">¶</a></span></h2></div></div></div><p>
Use the Search Preferences dialog box to set search preferences for
Beagle.
</p><div class="procedure"><ol class="procedure" type="1"><li><p>
Click <span class="guimenu">Computer</span>+<span class="guimenu">More
Applications</span>+<span class="guimenu">System</span>+<span class="guimenu">Search
Settings</span>.
</p><p>
You can also click <span class="guimenu">Search</span>+<span class="guimenu">Preferences</span> in the Desktop Search
dialog box.
</p><div class="informalfigure"><div class="mediaobject"><table border="0" summary="manufactured viewport for HTML img" cellspacing="0" cellpadding="0" width="69%"><tr><td><img src="images/beagle_preferences.png" width="100%" alt="Search Preferences dialog box"></td></tr></table></div></div></li><li><p>
Choose from the following options:
</p><p title="Start search & indexing services automatically:"><b>Start search & indexing services automatically: </b>
Select this option if you want the search daemon to start
automatically when you log in to your session (this option is selected
by default). If you want to use Beagle's Search functionality, the
daemon must be running.
</p><p title="Index data while on battery power:"><b>Index data while on battery power: </b>
Select this option if you want your data to be indexed when your
computer is operating on battery power. Disabling this option is
particularly useful if you are using openSUSE on a laptop and you
want to stop indexing when your laptop is running on battery power.
</p><p title="Index more aggressively while the screen saver is running:"><b>Index more aggressively while the screen saver is running: </b>
If the screen saver is running, it is assumed that you are not using
computer actively and more resources are dedicated to indexing. This
option does not apply if computer is running on battery power.
</p><p title="Automatically start searching after the user has stopped typing:"><b>Automatically start searching after the user has stopped typing: </b>
Select this option if you want Beagle to start searching as soon as
you stop entering text in the <span class="guimenu">Find</span> field in the
Desktop Search window. This option has no effect on the
<span class="guimenu">Search</span> field in the main menu.
</p><p title="Display the search window by pressing:"><b>Display the search window by pressing: </b>
Choose the keystrokes that will display the Desktop Search window by
specifying any combination of Ctrl, Alt and a function key. F12 is the
default keystroke.
</p></li><li><p>
Click <span class="guimenu">OK</span>.
</p></li></ol></div></div><div class="sect1" title="6.5. Indexing Other Directories"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.gnome.beagle.indexing"></a>6.5. Indexing Other Directories<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.gnome.beagle.indexing">¶</a></span></h2></div></div></div><p>
By default, Beagle indexes your home directory only. If you do not want
your home directory to be indexed, uncheck the <span class="guimenu">Index my home
directory </span>option on the <span class="guimenu">Indexing</span> tab of the
Search Preferences dialog box. If you want to index additional folders,
follow these steps:
</p><div class="procedure"><ol class="procedure" type="1"><li><p>
Click <span class="guimenu">Computer</span>+<span class="guimenu">More
Applications</span>+<span class="guimenu">System</span>+<span class="guimenu">Search
Settings</span>.
</p><p>
You can also click <span class="guimenu">Search</span>+<span class="guimenu">Preferences</span> in the Desktop Search
dialog box.
</p></li><li><p>
Click the <span class="guimenu">Indexing</span> tab.
</p><div class="informalfigure"><div class="mediaobject"><table border="0" summary="manufactured viewport for HTML img" cellspacing="0" cellpadding="0" width="69%"><tr><td><img src="images/beagle_indexing.png" width="100%" alt="Beagle indexing preferences"></td></tr></table></div></div></li><li><p>
Click <span class="guimenu">Add</span> in the <span class="guimenu">General</span> section
of the dialog box.
</p></li><li><p>
Select the directory you want to index and click
<span class="guimenu">Open</span>.
</p><p>
Make sure you have rights to the directories you add.
</p></li><li><p>
If you want to remove a directory from the list of indexed directories,
select it in the list, then click <span class="guimenu">Remove</span>.
</p></li><li><p>
Click <span class="guimenu">OK</span>.
</p></li></ol></div></div><div class="sect1" title="6.6. Preventing Files and Directories from Being Indexed"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.gnome.beagle.indexing_exclude"></a>6.6. Preventing Files and Directories from Being Indexed<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.gnome.beagle.indexing_exclude">¶</a></span></h2></div></div></div><p>
Use the Search Preferences dialog box to specify resources that you do
not want indexed. These resources can include directories, patterns, mail
folders, or types of objects.
</p><div class="procedure"><ol class="procedure" type="1"><li><p>
Click <span class="guimenu">Computer</span>+<span class="guimenu">More
Applications</span>+<span class="guimenu">System</span>+<span class="guimenu">Search
Settings</span>.
</p></li><li><p>
Click the <span class="guimenu">Indexing</span> tab.
</p></li><li><p>
Click <span class="guimenu">Add</span> in the <span class="guimenu">Privacy</span> section.
</p></li><li><p>
Select a resource to exclude from indexing, then specify the path to
the resource or filename pattern.
</p></li><li><p>
Click <span class="guimenu">OK</span> twice.
</p></li></ol></div></div><div class="sect1" title="6.7. Selecting Data Sources to Index"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id405887"></a>6.7. Selecting Data Sources to Index<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#id405887">¶</a></span></h2></div></div></div><p>
Beagle can index various data sources, data from various applications
(for example Evolution mails, memos and tasks, Pidgin conversations,
Tomboy notes or Nautilus metadata), files, applications, documentation,
man pages and others. To select which data sources Beagle should index,
follow these steps:
</p><div class="procedure"><ol class="procedure" type="1"><li><p>
Click <span class="guimenu">Computer</span>+<span class="guimenu">More
Applications</span>+<span class="guimenu">System</span>+<span class="guimenu">Search
Settings</span>.
</p></li><li><p>
Click the <span class="guimenu">Data Sources</span> tab.
</p></li><li><p>
Check the data sources you want to be indexed.
</p></li><li><p>
Click <span class="guimenu">OK</span>.
</p></li></ol></div></div><div class="sect1" title="6.8. Disabling Beagle"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id405969"></a>6.8. Disabling Beagle<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#id405969">¶</a></span></h2></div></div></div><p>
On low-end computers, Beagle may use too much resources. To disable
Beagle, click <span class="guimenu">Computer</span>+<span class="guimenu">More
Applications</span>+<span class="guimenu">System</span>+<span class="guimenu">Search
Settings</span>+<span class="guimenu">Searching</span> and uncheck
the <span class="guimenu">Start search & indexing services automatically</span>
option.
</p><p>
You can also disable Beagle by editing configuration files in the
<code class="filename">/etc/beagle/crawl-rules/</code> directory. To disable
Beagle, set option <code class="literal">CRAWL_ENABLED</code> to
<code class="literal">no</code> in all <code class="filename">crawl-*</code>files in the
directory.
</p></div><div class="sect1" title="6.9. For More Information"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.gnome.beagle.more"></a>6.9. For More Information<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.gnome.beagle.more">¶</a></span></h2></div></div></div><p>
More information about Beagle can be found on the following Web site:
</p><div class="itemizedlist"><ul class="itemizedlist" type="bullet"><li class="listitem" style="list-style-type: disc"><p>
<a class="ulink" href="http://beagle-project.org/" target="_top">Beagle Home Page</a>
</p></li></ul></div></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" border="0" class="bctable"><tr><td width="80%"><div class="breadcrumbs"><p><a href="index.html"> Documentation</a><span class="breadcrumbs-sep"> > </span><a href="book.gnomeuser.html">GNOME User Guide</a><span class="breadcrumbs-sep"> > </span><a href="part.gnome.manage.html">Internet Connectivity, Files and Resources</a><span class="breadcrumbs-sep"> > </span><strong><a accesskey="p" title="Chapter 5. Accessing Network Resources" href="cha.gnome.network.html"><span>◀</span></a> <a accesskey="n" title="Chapter 7. Managing Printers" href="cha.gnome.print.html"><span>▶</span></a></strong></p></div></td></tr></table></div></body></html>
ACC SHELL 2018