1TRACKER3-SEARCH(1)              Tracker manual              TRACKER3-SEARCH(1)
2
3
4

NAME

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

SYNOPSIS

9       tracker3 search [options...] [[expression1] ...]
10

DESCRIPTION

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

OPTIONS

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

SEE ALSO

115       tracker3-status(1), tracker3-tag(1), tracker3-info(1).
116
117
118
119  3.0.5                           04/03/2021                TRACKER3-SEARCH(1)
Impressum