Man page - localsearch-tag(1)

Packages contains this manual

Package: tracker-extract
apt-get install tracker-extract

Manuals in package:

Documentations in package:

tracker-extract

Manual

LOCALSEARCH-TAG

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO

NAME

localsearch-tag - Add, remove and list tags.

SYNOPSIS

localsearch tag FILE1 [FILE2 ...] [-l <limit>] [-o <offset>] [-r]
localsearch tag -t [[TAG1] [TAG2] ...] [-s] [-r]
localsearch tag -a <TAG> [-e <description>]
localsearch tag -d <TAG>

DESCRIPTION

List tags for local files or by the tag labels themselves if -t is used.

It’s also possible to manage tags with the -a and and -d options.

The FILE argument can be either a local path or a URI. It also does not have to be an absolute path.

OPTIONS

-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 TAG s are given, either matching tags are listed (OR condition). For example, this will match any tags named either foo , bar or baz :

$ localsearch 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 specified, 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 .

-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 number 10 in the results. The default is 0.

-n, --and-operator

Use AND operator for search terms instead of OR (the default). For example:

$ localsearch tag -s -t sliff sloff

Should show files in the database that have both the sliff and sloff tags.