'\" t
.\"     Title: localsearch-extract
.\"    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\-EXTRACT" "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-extract \- Show metadata extractor output\&.
.SH "SYNOPSYS"
.sp
\fBlocalsearch extract\fR \fIFILE\fR
.SH "DESCRIPTION"
.sp
\fBlocalsearch extract\fR reads the file provided and extracts any metadata it can from this file, then displays the metadata on standard output\&.
.sp
The metadata is displayed as RDF data, equivalent to the data inserted in the indexer database relative to the extracted file metadata\&. This RDF data can feasibly be imported in a compatible triple store\&.
.sp
The actual metadata extraction is done by a separate sandboxed process\&.
.SH "OPTIONS"
.PP
\fB\-o, \-\-output\-format=<\fR\fB\fIFORMAT\fR\fR\fB>\fR
.RS 4
Choose which format to use to output results\&. Supported formats are
\fIturtle\fR,
\fItrig\fR
and
\fIjson\-ld\fR\&.
.RE
.SH "EXAMPLES"
.PP
Using command line to extract metadata from a file
.RS 4
$ localsearch extract /path/to/some/file\&.mp3
.RE
.SH "SEE ALSO"
.sp
\fBlocalsearch status\fR(1), \fBlocalsearch info\fR(1)\&.