Introduction

Raven Pro can be invoked to open sounds and run detections from the command line. This can be useful when calling Raven from another software application or from a script.

Raven Lite can open sounds but not run detections.

Opening Sounds from the Command Line

Windows Command Prompt (in Windows)

Raven Lite 2.0.1

> cd "C:\Program Files\Raven Lite 2"
> "Raven Lite.exe" "%userprofile%\Raven Lite 2\Examples\BeardedSeal.aif" -viewPreset:"Default 1.3 Power"

Raven Pro 1.6.1

> cd "C:\Program Files\Raven Pro 1.6" 
> "Raven Pro.exe" "%userprofile%\Raven Pro 1.6\Examples\BeardedSeal.aif" -viewPreset:"Default 1.3 Power"

Terminal (in macOS):

Raven Lite 2.0.1

$ open -n '/Applications/Raven Lite 2.0/Raven Lite.App'

Raven Pro 1.6.1

$ open -n '/Applications/Raven Pro 1.6/Raven Pro.App'

Raven Pro 1.5 build 43*

$ open '/Applications/Raven Pro 1.5/Raven.App' --args '/Users/username/Desktop/BLED/BlackCappedVireo.aif' -viewPreset:"Default 1.3 Power"

* Command line invocation of detectors is broken in Raven Pro 1.6. To perform command line invocation of Raven detectors you must install Raven Pro 1.5 build 43.

Running Detections from the Command Line

Windows Command Prompt (in Windows)

Raven Pro 1.6

> cd "C:\Program Files\Raven Pro 1.6"
> "Raven Pro.exe" "%userprofile%\Raven Pro 1.6\Examples\BlackCappedVireo.aif" ^
  -viewPreset:"Default 1.3 Power" ^
  -detType:"Band Limited Energy Detector" ^
  -detPreset:"BlackCappedVireo.energy" ^
  -detTablePath:"%userprofile%\Raven Pro 1.6\Selections" ^
  -detTable:"BlackCappedVireo_TEST.selections.txt"

Terminal (in macOS):

Raven Pro 1.5 build 43*

$ open '/Applications/Raven Pro 1.5/Raven.App' --args '/Users/username/Desktop/BLED/BlackCappedVireo.aif' -detType:Band Limited Energy Detector -detPreset:BlackCappedVireo.energy -detTable:'/Users/username/Desktop/BLED/BlackCappedVireo.selections.txt'

* Command line invocation of detectors is broken in Raven Pro 1.6. To perform command line invocation of Raven detectors you must install Raven Pro 1.5 build 43.

To interpret the code above, it may be helpful to know that:

• “BeardedSeal.aif” and “BlackCappedVireo.aiff” are two of the audio files that you can find in the “Examples” folder in Raven. You could just as well specify a Raven list file instead. List files are described starting on page 195 of the Manual.
• “Default 1.3 Power” is a sound window preset included with Raven. Sound window presets are discussed on pages 71 – 74 of the Manual and in Sound Window Presets.
• “BlackCappedVireo.energy” is a custom preset for the Band Limited Energy Detector. It does not come installed in Raven, so you will have to create it. Information about the Band Limited Energy Detector, including tips for creating your own custom preset, can be found in DETECTION.
• Each command line invocation of Raven opens a new instance of Raven. To open a sound in an existing instance of Raven Lite in Mac OS X, use “-a” rather than “-n“.