Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, March 14, 2019
 
 

tracker-search (1)

Name

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

Synopsis

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

Description

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



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  dis-
              abled  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  rank-
              ing 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  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.


       TRACKER_PRAGMAS_FILE
              Tracker has a fixed set of  PRAGMA  settings  for  creating  its
              SQLite connection.  With this environment variable pointing to a
              text file you can override these settings. The file is a \n sep-
              arated  list  of  SQLite queries to execute on any newly created
              SQLite connection in tracker-store.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+--------------------------------+
       |ATTRIBUTE TYPE |        ATTRIBUTE VALUE         |
       +---------------+--------------------------------+
       |Availability   | library/desktop/search/tracker |
       +---------------+--------------------------------+
       |Stability      | Pass-through volatile          |
       +---------------+--------------------------------+
SEE ALSO
       tracker-store(1), tracker-stats(1), tracker-tag(1), tracker-info(1).



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was        downloaded         from          https://down-
       load.gnome.org/sources/tracker/1.6/tracker-1.6.0.tar.xz

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



GNU                                July 2009                 tracker-search(1)