tracker-search(1) User Commands tracker-search(1)NAMEtracker-search - Search all content for keywords
SYNOPSIStracker-search [OPTION...] EXPRESSION [EXPRESSION...]
DESCRIPTIONtracker-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
-?, --help-all
Display all help options available.
-l, --limit=N
Limit search to N results. The default is 10 or 512 with --dis‐
able-snippets.
-o, --offset=N
Offset the search results by N. For example, start at item num‐
ber 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. --music-
albums and --music-artists.
-f, --files
Search for files of any type matching EXPRESSION (optional).
-e, --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).
-l, --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.
-V, --version
Print version.
SEE ALSOtracker-store(1), tracker-stats(1), tracker-tag(1), tracker-info(1).
GNU July 2009 tracker-search(1)
