Queries

A query is a file search based on file attributes and can be performed within Tracker or in Terminal. Queries are saved in /boot/home/queries/ and by default last seven days before being purged. Note, these aren't static result lists of your search, but are the query formulas which trigger a new search whenever you open them.
Even better, you don't have to double-click to re-do a query. You can drill down a saved query just like any folder by right-clicking on it and navigating through the submenus.

The Find window

You start a query by invoking the Find... menu either from the Deskbar menu or any Tracker window or the Desktop (which is actually a fullscreen Tracker window). The shortcut is ALT F. You're presented with the Find window:

1. Select recent or saved queries or save the current search parameters as Query Template.

2. Narrow down your search from All files and folders to specific file types.

3. Define the search method:
   • by Name - a basic search by file or folder name
   • by Attribute - an advanced search, you specify search terms for one or more attributes
   • by Formula - an even more advanced search, you can fine-tune a complex query term

4. Select which drives to search on.

5. Enter the search term.

6. The expander hides/unhides the additional options.

7. Uncheck the Temporary checkbox if you don't want this query self-destruct after 7 days.

8. Check if your query is supposed to Include trash.

9. Optionally, enter a name for this query if you want to save it.

10. You can drag&drop the icon anywhere to save a query. Doing that with the right mouse button, offers the option to save as template.

Basic queries - "by Name"

If you simply want to find all files and folders on your mounted disks that match a certain pattern, simply leave the search method at by Name, enter the search term into the text box and press ENTER.

Advanced queries - "by Attribute"

You can create more advanced queries by searching within the attributes of specific file types. For that to work, these attributes have to be indexed.

You start by setting the filetype from All files and folders to, for example, Text | E-mail and change the search method to by Attribute.

This adds a pop-up menu to the left of the textbox and the buttons Add and Remove under that. From the menu you choose which attribute to query. With Add and Remove you can query additional attributes or remove them again. These attributes can be logically linked with AND/OR.

Let's do an email query as an example:

This is your Find window when you're looking for all emails Clara Botters has sent to you in the last two months that had in the subject "vibraphone" or "skepticality".
As you see, searching through time-based attributes supports some useful phrases: besides for the "last 2 months", you could also use "today", "yesterday", "Monday" or "last Monday" (which would be the Monday last week), or "last 2 minutes/hours/days/weeks".
A good way to cut down the number of search results.

Even more advanced queries - "by Formula"

Typing in a formula query by hand is daunting and really quite unpractical. It still has its uses.

Take the above query by attribute of Clara's mails concerning vibraphones etc. If you have all the attributes and their search terms set, try switching to by Formula mode and be overwhelmed by this one line query string:

Once more as text, edited for readability:

(((((MAIL:from=="*[cC][lL][aA][rR][aA] [bB][oO][tT][tT][eE][rR][sS]*")
       &&(MAIL:when>=%2 months%))
       &&(MAIL:subject=="*[vV][iI][bB][rR][aA][pP][hH][oO][nN][eE]*"))
       ||(MAIL:subject=="*[sS][kK][eE][pP][tT][iI][cC][aA][lL][iI][tT][yY]*"))
       &&(BEOS:TYPE=="text/x-email"))

What's the use?

• You could copy and paste the string into an email, forum or IRC for others to use or debug.

• You can use this method to construct a query in Attribute mode and then switch to Formula mode, to comfortably generate a search string to use for a query in Terminal or a script.

• You can fine tune your query by inserting parenthesis where needed, make parts case-sensitive or negate logical combinations by changing. e.g. "==" to "!=" for a NOT AND. All you need is a basic understanding of regular expressions and maybe some scripting basics.

The result window

After you start a search, the Find window will be replaced by a result window. Here is an example that queried for "server":

Besides the gray background, result windows work exactly like any other Tracker window. Some things are worth noting:

• You can open the location of a file or folder by double clicking on its path attribute.

• With File | Edit query or ALT G you get back to your Find window to refine your query.

• A query is live, i.e. if a file that matches your search criteria appears or disappears from your system, this change is reflected in your results in real-time.

You can assign a sensible attribute layout for query results of a specific filetype. Open a folder containing files of the filetype you'd like to create a template for and arrange the attributes how you'd like to have query results presented. Copy this layout with Attributes | Copy layout.

Open /boot/home/config/settings/Tracker/DefaultQueryTemplates, create a new folder named group/filetype, replacing the slash with an underscore, e.g. "audio_x-mp3". Open the new folder and paste in the previously copied layout with Attributes | Paste layout.

Query Templates

If you double click a saved query, the file search is at once started and the result window opens immediately. However, you may not want to search with these exact search parameters, but use it as starting point to only slightly tweak the formula.
By using the Save query as template menu item (see (1) in screenshot at the top) or drag&dropping the icon (10) anywhere with the right mouse button, you can create just such a template. Double clicking it won't open a result window, but the Find panel, giving you the opportunity to quickly change search strings or add/remove attributes.

Wherever you choose to save query templates, they'll be listed in the Find panel's menu of recent queries.