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)