NAME

       tracker-search - Search for content by type or across all types

SYNOPSIS

       tracker search [options...] [[expression1] ...]

DESCRIPTION

       tracker search searches all indexed content for expression. The resource in which expression matches must
       exist (see --all for more information). All results are returned in ascending order. In all cases, if  no
       expression  is  given  for  an  argument (like --folders for example) then ALL items in that category are
       returned instead.

       expression
              One or more terms to search. The default operation is a logical AND.  For logical  OR  operations,
              see -r.

OPTIONS

       -f, --files
              Search for files of any type matching expression (optional).

       -s, --folders
              Search for folders matching expression (optional).

       -m, --music
              Search for music files matching expression (optional).

       --music-albums
              Search for music albums matching expression (optional).

       --music-artists
              Search for music artists matching expression (optional).

       -i, --images
              Search for images matching expression (optional).

       -v, --videos
              Search for videos matching expression (optional).

       -t, --documents
              Search for documents matching expression (optional).

       -e, --emails
              Search for emails matching expression (optional). Returns a list of subjects for emails found.

       -c, --contacts
              Search  for  contacts  matching expression (optional). Returns a list of names and email addresses
              found.

       --software
              Search for software installed matching expression (optional). Returns a list of desktop files  and
              application titles found.

       --software-categories
              Search  for  software  categories matching expression (optional). Returns a list of urns and their
              categories (e.g. Settings, Video, Utility, etc).

       --feeds
              Search through RSS feed information matching expression (optional). Returns a list of those found.

       -b, --bookmarks
              Search through bookmarks matching expression (optional). Returns a list titles and links for  each
              bookmark found.

       -l, --limit=<limit>
              Limit search to limit results. The default is 10 or 512 with --disable-snippets.

       -o, --offset=<offset>
              Offset  the  search  results  by  offset. For example, start at item number 10 in the results. The
              default is 0.

       -r, --or-operator
              Use OR for search terms instead of AND (the default)

       -d, --detailed
              Show the unique URN associated with each search result. This does not apply to --music-albums  and
              --music-artists.

       -a, --all
              Show  results  which might not be available. This might bebecause a removable media is not mounted
              for example. Without this option, resources are only shown if they exist. This option  applies  to
              all command line switches except

       --disable-snippets
              Results are shown with snippets. Snippets are context around the word that was searched for in the
              first place. This gives some idea of if the resource found is the right one. Snippets require Full
              Text  Search  to  be  compile  time  enabled  AND  to  not  be  disabled with --disable-fts. Using
              --disable-snippets only shows the resources which matched, no context is provided about where  the
              match occurred.

       --disable-fts
              If Full Text Search (FTS) is available, this option allows it to be disabled for one off searches.
              This returns results slightly  using  particular  properties  to  match  the  search  terms  (like
              "nie:title")  instead  of looking for the search terms amongst ALL properties. It is more limiting
              to do this, but sometimes searching without FTS can yield better results if  the  FTS  ranking  is
              off.

       --disable-color
              This disables any ANSI color use on the command line. By default this is enabled to make it easier
              to see results.

ENVIRONMENT

       TRACKER_SPARQL_BACKEND
              This option allows you to choose which backend you use for connecting to the database. This choice
              can limit your functionality. There are three settings.

              With  "direct"  the  connection  to  the database is made directly to the file itself on the disk,
              there is no intermediary daemon or process. The "direct" approach is purely read-only.

              With "bus" the tracker-store process is used to liase with the database queuing all  requests  and
              managing  the  connections  via  an  IPC  / D-Bus. This adds a small overhead BUT this is the only
              approach you can use if you want to write to the database.

              With "auto" the backend is decided for you, much like it would be if this environment variable was
              undefined.

SEE ALSO

       tracker-store(1), tracker-stats(1), tracker-tag(1), tracker-info(1).