localsearch-tag1
Add, remove and list tags.
Usage
localsearch tag
FILE
[-l
<limit>]
[-o
<offset>]
[-r]
localsearch tag
-t
[-s]
[-r]
FILE
localsearch tag
-a
<TAG>
[-e
<description>]
localsearch tag
-d
<TAG>
Overview
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.
-
-s, --show-files -
Show the files associated with each tag. This option is ONLY available WITH the
--listoption.
-
-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
--addand 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.
Releases
2 releases since Debian 13 (Trixie); the text changed 1 time.
--and-operator until Debian 13 (Trixie);
-n until Debian 13 (Trixie).