VVCLI1 is a cross-platform, command line tool with modules for encode, rotate and decode. VVCLI1 uses the same algorithms as VVEncode and VVDecode so you can script your ambisonic processing and be assured of getting the same results you heard in real time. VVCLI1 is first order only. For higher order command line processing, see vvclih.


Note: vvcli1 requires the open source library libsndfile.

An installer for Windows can be downloaded from here: http://www.mega-nerd.com/libsndfile/#Download

Instructions for installing libsndfile on OSX can be found here: http://macappstore.org/libsndfile/

For a Mac M1 native version go here: https://github.com/jurihock/libsndfile-binaries
When run without parameters, vvcli1 will output the following help message. The first line shows an example of simultaneously encoding a file from A to B format, then decoding it to XY along with a 5 degree rotate.
VVCLI -- command line interface to VVAudio UGens

usage: vvcli -in-file xyz.wav -out-file fooXY.wav -encode-path calibrations -encode-pgm 2003 -rotate 5 -decode-pgm XY

  -help - list command line options
  -in-file   - input file. enclose multiple input files in quotes
  -in-fmt         - input format: FuMa, AmbiX
  -out-file  - output file. full name for single file or name stem for file sets
  -out-fmt        - output format: FuMa, AmbiX
  -realtime-out - play to default output device
  -encode-path   - path to directory where calibrations files are
  -encode-pgm  - encode program like '2003'
  -rotate  - amount of counterclockwise rotation
  -tilt    - amount of counterclockwise tilt
  -tumble  - amount of upward tumble
  -flip-X - flip front to back
  -flip-Y - flip left to right
  -flip-Z - flip top to bottom
  -spin-rate  - rate of rotation per block
  -decode-pgm  - linear decode program to use like 'XY' or 'Cube'
  -master-gain  - final output gain in dB like -3 or 2.3
  -tail  - adds given number of samples to the end of the output
  -frontal-emphasis  - from 0.0 to 1.0, makes overall response more directional
  -multi-angle  - output multiple files, rotated by the given angle, '90' will create 4 files

Available encode programs:
Encode path: 
  PGM1 : zb109

Available linear decode programs:
  PGM1 : XY
  PGM2 : ORTF-ish
  PGM3 : 180-cards
  PGM4 : Blumlein
  PGM5 : 5.1 SMPTE
  PGM6 : 5.1 film
  PGM7 : Square
  PGM8 : Hexagon
  PGM9 : Octagon
  PGM10 : Cube
  PGM11 : Rectangle

vvcli1 runs on both Windows and OSX. It is not available separately, but can only be purchased as a part of the bundle VVStandard.