LV2FILE(1)						      General Commands Manual							LV2FILE(1)

NAME

       lv2file - Apply LV2 effects to audio files

SYNOPSIS

       lv2file
	      -l|--list
	      -n|--nameports PLUGIN
	      -i INFILE -o OUTFILE [ OPTIONS ] PLUGIN

DESCRIPTION

       lv2file is aprogram which you can use to apply effects to your audio files without much hassle. Possible use cases are:
	      * To apply an effect without having to open a GUI or start a project.
	      * To apply effects to a large number of files, or in an automated manner.
	      * A deterministic environment to debug a plugin.
	      * Audio editing in a command-line only environment
       lv2file uses the LV2 plugin format (http://lv2plug.in/) for the effects it uses.

OPTIONS

       lv2file	follows  the  usual  GNU  command line syntax, with long options starting with two dashes (`-').  A summary of options is included
       below.

       -l, --list
	      List and number all available plugins.

       -n --nameports PLUGIN
	      List all the input and control ports for the specified plugin.

       -i FILE
	      Input the audio from a given FILE.  Most common sampled audio formats are supported.

       -o FILE
	      Output to given FILE.

       -c, --connect CHANNEL:PORT
	      Connect the channel CHANNEL in the input file to the audio port PORT of the plugin.  If you connect multiple channels  to  the  same
	      port, they will be mixed together.  The -c option is often not necessary, as lv2file will try to guess how you would like to connect
	      the ports.
	      It is possible to run multiple instances of a plugin using the syntax "-c 5:2.left" which, for  example,	would  connect	the  fifth
	      channel  of  audio  to the port labeled "left" in the second copy of the plugin.	You don't need to specify how many plugins to run,
	      lv2file automatically makes enough according to the connections you make.

       -p, --parameters PORT:VALUE
	      Pass values to the control ports of the plugin, essentially telling the effect how to handle the audio.  PORT is	the  name  of  the
	      control port, and VALUE is the value to set it to.  For example "-p volume:1" sets the effects "volume" control to 1.

	      You should note that because lv2file uses LV2 plugins, the VALUES will always be floating point numbers.	It is not possible to vary
	      a parameter with time.  It is also not possible to have different control values for multiple plugin instances.  Instead,  split	up
	      the channels of your audio files, and process them in batches whose parameters are all the same.

       [ -m --mono ]
	      Mix  down all of the channels together and pass them to the plugin. This will only work if the plugin has only a single audio input.
	      This is to be used instead of manually specifying connections.

       [ -b, --blocksize N ]
	      The size of the chunks the audio is processed in.  This might have implications for speed of processing.	N is measured  in  frames,
	      not samples.  The default is 512.

       [ --ignore-clipping ]
	      By  default,  lv2file will check every sample for clipping and will warn the user if any clipping occurs.  However, if know that the
	      effect won't produce clipping, or you don't care if it does, you can use this option to turn off the check for clipping.	This  will
	      make lv2file run slightly faster.

AUTHOR

       lv2file was written by Jeremy Salwen <jeremysalwen@gmail.com>.

       This manual page was written by Jeremy Salwen <jeremysalwen@gmail.com>, for the Debian project (and may be used by others).

								  March 14, 2011							LV2FILE(1)