'\" t
.\"     Title: localsearch-search
.\"    Author: The LocalSearch developers
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 12/10/2025
.\"    Manual: LocalSearch manual
.\"    Source: \ \& 3.10.2
.\"  Language: English
.\"
.TH "LOCALSEARCH\-SEARCH" "1" "12/10/2025" "\ \& 3\&.10\&.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-search \- Search for content
.SH "SYNOPSIS"
.sp
\fBlocalsearch search\fR [\fIoptions\fR\&...] [\fIresource\-type\fR] <search\-terms>
.SH "DESCRIPTION"
.sp
\fBlocalsearch search\fR searches all indexed content for the given search terms\&. Results are returned in ascending order\&.
.PP
\fI<search\-terms>\fR
.RS 4
One or more words to search for\&. When multiple terms are provided, the default operation is a logical AND\&. For logical OR operations, see
\fB\-r\fR\&.
.sp
If no search terms are supplied, then all items are returned\&.
.RE
.sp
Only resources which currently exist will be returned by this command (see \fB\-\-all\fR for more information)\&.
.SH "RESOURCE TYPES"
.PP
\fB\-f, \-\-files\fR
.RS 4
Search for files of any type matching
\fIsearch\-terms\fR\&.
.RE
.PP
\fB\-s, \-\-folders\fR
.RS 4
Search for folders matching
\fIsearch\-terms\fR\&.
.RE
.PP
\fB\-m, \-\-music\fR
.RS 4
Search for music files matching
\fIsearch\-terms\fR\&.
.RE
.PP
\fB\-\-music\-albums\fR
.RS 4
Search for music albums matching
\fIsearch\-terms\fR\&.
.RE
.PP
\fB\-\-music\-artists\fR
.RS 4
Search for music artists matching
\fIsearch\-terms\fR\&.
.RE
.PP
\fB\-i, \-\-images\fR
.RS 4
Search for images matching
\fIsearch\-terms\fR\&.
.RE
.PP
\fB\-v, \-\-videos\fR
.RS 4
Search for videos matching
\fIsearch\-terms\fR\&.
.RE
.PP
\fB\-t, \-\-documents\fR
.RS 4
Search for documents matching
\fIsearch\-terms\fR\&.
.RE
.PP
\fB\-\-software\fR
.RS 4
Search for software files matching
\fIsearch\-terms\fR\&.
.RE
.SH "OPTIONS"
.PP
\fB\-l, \-\-limit=<\fR\fB\fIlimit\fR\fR\fB>\fR
.RS 4
Limit search to
\fIlimit\fR
results\&.
.RE
.PP
\fB\-o, \-\-offset=<\fR\fB\fIoffset\fR\fR\fB>\fR
.RS 4
Offset the search results by
\fIoffset\fR\&. For example, start at item number 10 in the results\&. The default is 0\&.
.RE
.PP
\fB\-d, \-\-detailed\fR
.RS 4
Show the unique URN associated with each search result and a snippet of the matched search terms, if any was provided\&.
.RE
.PP
\fB\-a, \-\-all\fR
.RS 4
Show results which might not be available\&. This might bebecause a removable media is not mounted for example\&. Without this option, resources are only shown if they exist\&.
.RE
.SH "SEE ALSO"
.sp
\fBlocalsearch status\fR(1), \fBlocalsearch tag\fR(1), \fBlocalsearch info\fR(1)\&.