.TH "VAMP-SIMPLE-HOST" "1" 
.SH "NAME" 
vamp-simple-host \(em a simple Vamp plugin host 
.SH "SYNOPSIS" 
.PP 
\fBvamp-simple-host\fR [\-s]  [\fIpluginlibrary\fR[.so]:\fIplugin\fR[:\fIoutput\fR]]  [file]  [\fB-o\fP\fI outfile\fR]  
.PP 
\fBvamp-simple-host\fR [\-s]  [\fIpluginlibrary\fR[.so]:\fIplugin\fR]  [file]  [[\fIoutputno\fR]]  [\fB-o\fP\fI outfile\fR]  
.SH "DESCRIPTION" 
.PP 
This manual page documents briefly the 
\fBvamp-simple-host\fR command. 
.PP 
\fBvamp-simple-host\fR allows processing of a 
libsndfile-readable audio file using Vamp plugins, listing 
available plugins and the plugin search path. 
.PP 
By default, \fBvamp-simple-host\fR loads plugin 
id \fIplugin\fR from 
\fIpluginlibrary\fR and runs it on the 
audio data in \fIfile\fR, retrieving the 
named \fIoutput\fR, or output number 
\fIoutputno\fR (the first output by 
default) and dumping it to standard output, or 
to \fIoutfile\fR if 
the \fB-o\fP option is given. 
.PP 
\fIpluginlibrary\fR should be a library 
name, not a file path; the standard Vamp library search path 
will be used to locate it.  If a file path is supplied, the 
directory part(s) will be ignored. 
.PP 
If the \fB-s\fP option is given, results will be 
labelled with the audio sample frame at which they 
occur. Otherwise, they will be labelled with time in 
seconds. 
.SH "OPTIONS" 
.IP "\fB-l\fP, \fB\-\-list\fP" 10 
List the plugin libraries and Vamp plugins in the 
library search path in a verbose human-readable format. 
.IP "\fB\-\-list-full\fP" 10 
List all data reported by all the Vamp plugins in the 
library search path in a very verbose human-readable 
format. 
.IP "\fB\-\-list-ids\fP" 10 
List the plugins in the search path in a terse 
machine-readable format, in the form 
vamp:soname:identifier. 
.IP "\fB\-\-list-outputs\fP" 10 
List the outputs for plugins in the search path in a 
machine-readable format, in the form 
vamp:soname:identifier:output. 
.IP "\fB\-\-list-by-category\fP" 10 
List the plugins as a plugin index by category, in a 
machine-readable format. The format may change in future 
releases. 
.IP "\fB-p\fP" 10 
Print out the Vamp library search path. 
.IP "\fB-s\fP" 10 
Label results with the audio sample frame at which 
they occur. Otherwise, they will be labelled with time in 
seconds. 
.IP "\fB-o \fIfile\fR\fP" 10 
Dump plugin output 
into \fIfile\fR. 
.IP "\fB-v\fP" 10 
Display version information only. 
.SH "ENVIRONMENT" 
.IP "VAMP_PATH" 10 
A colon-separated list of directories to look for 
plugins. 
.SH "AUTHOR" 
.PP 
This manual page was written by Székelyi Szabolcs cc@mail.3d.hu for 
the \fBDebian\fP system (but may be used by others), because the 
original program does not have a manual page.  Permission is 
granted to copy, distribute and/or modify this document under 
the terms of the GNU General Public License, Version 2 any 
later version published by the Free Software Foundation. 
.PP 
On Debian systems, the complete text of the GNU General Public 
License can be found in /usr/share/common-licenses/GPL. 
.\" created by instant / docbook-to-man