localsearch-tag − Add, remove and list tags.
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).