Manpage logo

localsearch-tag - Add, remove and list tags.

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  SEE ALSO 

NAME

localsearch-tag − Add, remove and list tags.

SYNOPSIS

localsearch tag FILE [−l <limit>] [−o <offset>] [−r]
localsearch tag −t [−s] [−r] FILE
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.

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

SEE ALSO

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


Updated 2026-06-01 - jenkler.se | uex.se