'\" t
.\"     Title: localsearch-tag
.\"    Author: The LocalSearch developers
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 09/01/2026
.\"    Manual: LocalSearch manual
.\"    Source: \ \& 3.11.2
.\"  Language: English
.\"
.TH "LOCALSEARCH\-TAG" "1" "09/01/2026" "\ \& 3\&.11\&.2" "LocalSearch manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
localsearch-tag \- Add, remove and list tags\&.
.SH "SYNOPSIS"
.sp
.nf
localsearch tag FILE [\-l <limit>] [\-o <offset>] [\-r]
localsearch tag \-t [\-s] [\-r] FILE
localsearch tag \-a <TAG> [\-e <description>]
localsearch tag \-d <TAG>
.fi
.SH "DESCRIPTION"
.sp
List tags for local files or by the tag labels themselves if \-t is used\&.
.sp
It\(cqs also possible to manage tags with the \-a and and \-d options\&.
.sp
The \fIFILE\fR argument can be either a local path or a URI\&. It also does not have to be an absolute path\&.
.SH "OPTIONS"
.PP
\fB\-t, \-\-list\fR
.RS 4
List all tags\&. Results include the number of files associated with that tag and the tag\(cqs unique identifier\&. You can show the files associated with each tag by using \-\-show\-files\&.
.RE
.PP
\fB\-s, \-\-show\-files\fR
.RS 4
Show the files associated with each tag\&. This option is ONLY available WITH the
\fB\-\-list\fR
option\&.
.RE
.PP
\fB\-a, \-\-add=TAG\fR
.RS 4
Add a tag with the name
\fITAG\fR\&. If no
\fIFILE\fR
argument is specified, the tag is simply created (if it didn\(cqtalready exist) and no files are associated with it\&.
.RE
.PP
\fB\-d, \-\-delete=TAG\fR
.RS 4
Delete a tag with the name
\fITAG\fR\&. If no
\fIFILE\fR
argument is specified, the tag is deleted for ALL files\&.
.RE
.PP
\fB\-e, \-\-description=STRING\fR
.RS 4
This option ONLY applies when using
\fB\-\-add\fR
and provides a description to go with the tag label according to
\fISTRING\fR\&.
.RE
.PP
\fB\-l, \-\-limit=N\fR
.RS 4
Limit search to N results\&. The default is 512\&.
.RE
.PP
\fB\-o, \-\-offset=N\fR
.RS 4
Offset the search results by N\&. For example, start at item number 10 in the results\&. The default is 0\&.
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
$ localsearch tag \-s \-t banana
.fi
.if n \{\
.RE
.\}
.sp
Should show files in the database that have both the \fIbanana\fR tag\&.
.SH "SEE ALSO"
.sp
\fBlocalsearch search\fR(1), \fBlocalsearch info\fR(1)\&.