1tracker-search(1)                User Commands               tracker-search(1)
2
3
4

NAME

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

SYNOPSIS

10       tracker search [options...] [[expression1] ...]
11
12

DESCRIPTION

14       tracker  search  searches  all  indexed  content  for  expression.  The
15       resource in which expression matches must exist  (see  --all  for  more
16       information).  All  results  are  returned  in  ascending order. In all
17       cases, if no expression is given for an argument  (like  --folders  for
18       example) then ALL items in that category are returned instead.
19
20       expression
21              One  or more terms to search. The default operation is a logical
22              AND.  For logical OR operations, see -r.
23
24

OPTIONS

26       -f, --files
27              Search for files of any type matching expression (optional).
28
29       -s, --folders
30              Search for folders matching expression (optional).
31
32       -m, --music
33              Search for music files matching expression (optional).
34
35       --music-albums
36              Search for music albums matching expression (optional).
37
38       --music-artists
39              Search for music artists matching expression (optional).
40
41       -i, --images
42              Search for images matching expression (optional).
43
44       -v, --videos
45              Search for videos matching expression (optional).
46
47       -t, --documents
48              Search for documents matching expression (optional).
49
50       -e, --emails
51              Search for emails matching expression (optional). Returns a list
52              of subjects for emails found.
53
54       -c, --contacts
55              Search  for  contacts  matching expression (optional). Returns a
56              list of names and email addresses found.
57
58       --software
59              Search for software installed  matching  expression  (optional).
60              Returns a list of desktop files and application titles found.
61
62       --software-categories
63              Search  for  software categories matching expression (optional).
64              Returns a list of urns  and  their  categories  (e.g.  Settings,
65              Video, Utility, etc).
66
67       --feeds
68              Search   through   RSS   feed  information  matching  expression
69              (optional). Returns a list of those found.
70
71       -b, --bookmarks
72              Search through bookmarks matching expression (optional). Returns
73              a list titles and links for each bookmark found.
74
75       -l, --limit=<limit>
76              Limit  search  to  limit  results. The default is 10 or 512 with
77              --disable-snippets.
78
79       -o, --offset=<offset>
80              Offset the search results by offset. For example, start at  item
81              number 10 in the results. The default is 0.
82
83       -r, --or-operator
84              Use OR for search terms instead of AND (the default)
85
86       -d, --detailed
87              Show  the  unique  URN  associated with each search result. This
88              does not apply to --music-albums and --music-artists.
89
90       -a, --all
91              Show results which might not be available. This might  bebecause
92              a  removable  media  is  not  mounted  for example. Without this
93              option, resources are only shown  if  they  exist.  This  option
94              applies to all command line switches except
95
96       --disable-snippets
97              Results are shown with snippets. Snippets are context around the
98              word that was searched for in the first place. This  gives  some
99              idea of if the resource found is the right one. Snippets require
100              Full Text Search to be compile time enabled AND to not  be  dis‐
101              abled  with  --disable-fts.  Using --disable-snippets only shows
102              the resources which matched, no context is provided about  where
103              the match occurred.
104
105       --disable-fts
106              If Full Text Search (FTS) is available, this option allows it to
107              be disabled for one off searches. This returns results  slightly
108              using  particular  properties  to  match  the search terms (like
109              "nie:title") instead of looking for the search terms amongst ALL
110              properties.  It  is  more  limiting  to  do  this, but sometimes
111              searching without FTS can yield better results if the FTS  rank‐
112              ing is off.
113
114       --disable-color
115              This disables any ANSI color use on the command line. By default
116              this is enabled to make it easier to see results.
117
118

ENVIRONMENT

120       TRACKER_SPARQL_BACKEND
121              This option allows you to choose which backend you use for  con‐
122              necting  to the database. This choice can limit your functional‐
123              ity. There are three settings.
124
125              With "direct" the connection to the database is made directly to
126              the  file itself on the disk, there is no intermediary daemon or
127              process. The "direct" approach is purely read-only.
128
129              With "bus" the tracker-store process is used to liase  with  the
130              database  queuing  all requests and managing the connections via
131              an IPC / D-Bus. This adds a small overhead BUT this is the  only
132              approach you can use if you want to write to the database.
133
134              With  "auto"  the backend is decided for you, much like it would
135              be if this environment variable was undefined.
136
137

SEE ALSO

139       tracker-store(1), tracker-stats(1), tracker-tag(1), tracker-info(1).
140
141
142
143GNU                                July 2009                 tracker-search(1)