Searching the Library

The library search box is located immediately below the library tree on the TealPlay main window. To the right of the search box are two buttons: the search button and the clear search button.

search box and buttons

Simple Searches

To search the names and descriptions of containers and playables, simply type the search terms into the search box, then press Enter or click the search button. If multiple search terms are given, then the query is processed by joining those terms together using AND logic. Matches will have all individual words in the name and/or description.

Once a search is initiated, the search box and search buttons will become temporarily unavailable. Searching may take a few moments, depending upon the size of the library. Larger libraries take longer to search than do smaller ones.

To search for a phrase, put either single or double quotes around the phrase:

searching by phrase

Negation of Terms

A search term or phrase can be negated by starting it with an exclamation point (!) character. For a phrase, the ! can be placed immediately before the opening quote or as the first word of the quoted phrase:

negating a search phrase

Note that negation is applied to each term of a search separately. Thus, a non-phrase search for buck !bunny would look for an item whose name or description contains buck AND whose name or description does NOT contain bunny.

Search Results

Once a search is complete, the results are shown by filtering the library tree to show only items that match. All nodes of the tree are also expanded automatically. If a container matches a search query, but none of its playable items match, then the container will be shown as a leaf node in the filtered tree (with no items under it). This container can be dragged to the playlist to add all playables that are found inside the container or any of its child containers.

To clear the search results, press the clear search button. The library tree will be returned to its original state and fully collapsed.

Searching by Genre, Mood, Style, Tag, or Theme

It is possible to search by any of the genre, mood, style, tag, or theme properties by prepending genre:, mood:, style:, tag: or theme: to the search term. This document will demonstrate searching by genre, but the principles are the same for any of the other properties. To search for the education genre, use the following query:

genre:education

Multiple values can be specified by separating them with semicolons (;). If multiple values are used in a property search, then the values are joined using OR logic. Thus, to search for content that is in the education OR animation genre, use:

genre:education;animation

Values can also be negated with the ! sign:

genre:!education

Finally, if a value of a property contains a space, quote it:

genre:'science fiction'