localsearch-tag - Man Page

localsearch tag FILE [-l <limit>] [-o <offset>] [-r]
localsearch tag -t [-s] [-r] FILE
localsearch tag -a <TAG> [-e <description>]
localsearch tag -d <TAG>

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​.

-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​.

-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 argument is specified, the tag is simply created (if it didn’talready exist) and no files are associated with it​.

-d,  --delete=TAG

Delete a tag with the name TAG​. If no FILE argument is specified, the tag is deleted for ALL files​.

-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​.

$ localsearch tag -s -t banana

Should show files in the database that have both the banana tag​.

localsearch search(1), localsearch info(1)​.