Beagle is a search tool that indexes your personal information space to help you find whatever you are looking for. You can use Beagle to find documents, e-mails, Web history, IM/ITC conversations, source code, images, music files, applications, and much more.
Beagle supports the following data sources:
Evolution mail and address book
Gaim instant messaging logs
Firefox Web pages (as you view them)
Blam and Liferea RSS aggregators
It also supports the following file formats:
Microsoft Office (doc, ppt, xls)
Images (jpeg, png)
Audio (mp3, ogg, flac)
Rich Text Format (rtf)
Beagle automatically indexes everything in your home directory, but you can choose to exclude certain files or directories. Beagle also includes a variety of tools that you can use to search your data.
The Beagle daemon (beagled) automatically performs all indexing. By default, everything in your home directory gets indexed. Beagle detects changes made to your home directory and reindexes the data accordingly.
Files are immediately indexed when they are created, reindexed when they are modified, and dropped from the index when they are deleted.
E-mails are indexed upon arrival.
IM conversations are indexed as you chat, one line at a time.
Indexing your data requires a fair amount of computing power, but the Beagle daemon tries to be as unobtrusive as possible. It contains a scheduler that works to prioritize tasks and control CPU usage, based on whether you are actively using your workstation.
To prevent a directory (and all of its subdirectories) from
being indexed, create an empty file named
and place it in the directory. Add a list of files and
directories to the
.noindex file to prevent those
files and directories from being indexed. Wild cards are permitted in
You can also put a
.neverindex file in your home
directory with a list of files that should never be indexed. Wild cards
are also allowed in this file. Use the same wild cards as you use for
glob (for example, f*le??.txt). You can also use
more powerful regular expressions by adding a forward slash both before
and after your pattern (for example, /file.*.txt/). For more
information, see http://docs.python.org/lib/module-glob.html.
Beagle is smart about how it determines when to index your files and it tries to not interfere with other running applications. It intentionally times its indexing based on load and whether your system is idle to avoid adversely affecting your desktop experience. To index your home directory right away, enter the following commands in a terminal window:
export BEAGLE_EXERCISE_THE_DOG=1 beagled --replace --bg
Beagle includes the following commands to let you see the current indexing status:
Displays how many documents have been indexed and what type of documents have been indexed.
Displays the current work the Beagle daemon is doing (on an ongoing basis).