tracker-tag(1) User Commands tracker-tag(1)NAMEtracker-tag - Add, remove and list tags.
SYNOPSIStracker-tag [OPTION...] FILE [FILE...]
tracker-tag [OPTION...] -t [[TAG] [TAG] ...]
DESCRIPTIONtracker-tag allows the caller add tags, remove tags and list tags by
URN or to list all tags and the files associated with them.
The FILE argument can be either a local path or a URI. It also does not
have to be an absolute path.
OPTIONS
-?, --help
Show summary of options.
-l, --limit=N
Limit search to N results. The default is 512.
-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)
-t, --list
List all tags. Results include the number of files associated
with that tag and the tag's unique identifier. You can show the
files associated with each tag by using --show-files.
The TAG arguments are optional. If no TAG argument is specified,
all tags are listed. If one or more TAGs are given, all matching
tags are listed. For example, this will match any tags named
either foo, bar or baz:
$ tracker-tag-t foo bar baz
-s, --show-files
Show the files associated with each tag. This option is ONLY
available WITH the --list option.
-a, --add=TAG
Add a tag with the name TAG. If no FILE arguments are specified,
the tag is simply created (if it didn'talready exist) and no
files are associated with it. Multiple FILE arguments can be
specified.
-d, --delete=TAG
Delete a tag with the name TAG. If no FILE arguments are speci‐
fied, the tag is deleted for ALL files. If FILE arguments are
specified, only those files have the TAG deleted.
-e, --description=STRING
This option ONLY applies when using --add and provides a
description to go with the tag label according to STRING.
-V, --version
Print version.
SEE ALSOtracker-store(1), tracker-sparql(1), tracker-search(1), tracker-
info(1).
GNU July 2009 tracker-tag(1)
