Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022

tracker-search (1)


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


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


tracker-search(1)                User Commands               tracker-search(1)

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

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

       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.

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

       -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).

              Search for music albums matching expression (optional).

              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.

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

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

              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

       -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

              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  dis-
              abled  with  --disable-fts.  Using --disable-snippets only shows
              the resources which matched, no context is provided about  where
              the match occurred.

              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  rank-
              ing is off.

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

              This option allows you to choose which backend you use for  con-
              necting  to the database. This choice can limit your functional-
              ity. 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 attributes(7) for descriptions of the following attributes:

       |ATTRIBUTE TYPE |        ATTRIBUTE VALUE         |
       |Availability   | library/desktop/search/tracker |
       |Stability      | Pass-through volatile          |

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

       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was        downloaded         from          https://down-

       Further information about this software can be found on the open source
       community website at https://www.gnome.org/.

GNU                                July 2009                 tracker-search(1)