1tracker-search(1) User Commands tracker-search(1)
2
3
4
6 tracker-search - Search for content by type or across all types
7
8
10 tracker search [options...] [[expression1] ...]
11
12
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
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
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
138 TRACKER_PRAGMAS_FILE
139 Tracker has a fixed set of PRAGMA settings for creating its
140 SQLite connection. With this environment variable pointing to a
141 text file you can override these settings. The file is a \n sep‐
142 arated list of SQLite queries to execute on any newly created
143 SQLite connection in tracker-store.
144
145
147 tracker-store(1), tracker-stats(1), tracker-tag(1), tracker-info(1).
148
149
150
151GNU July 2009 tracker-search(1)