Using_Xena_via_the_command_line

This page describes how to run Xena from the command line.

As you are running Xena from the command line, you must include the following arguments:

• file/s to be normalised
• plugins directory
• output directory.

Note: If you are normalising large files or archive formats (such as zip or mbox) containing a large number of files, you may need to set the maximum heap space when starting Xena. See [Known_Issues] for more information.

Command line help

To access help:

java -jar xena.jar --help

The help contents are displayed below:

usage: xena
-f,--file <arg>               Input files
-h,--help                     Print usage information
-o,--outputDirectory <arg>    Output directory
-p,--pluginsDirectory <arg>   Path to plugins directory
-v,--version                  Print version information

Windows

The following example includes reference to the audio.jar plugin, required for normalising audio files:

java -cp xena.jar;plugins/audio.jar au.gov.naa.digipres.xena.core.XenaMain -f C:\Documents and Settings\testing\test.flac  -p plugins/ -o C:\Documents and Settings\xena_output

Linux

The following example includes reference to the audio.jar plugin, required for normalising audio files:

java -cp xena.jar:plugins/audio.jar au.gov.naa.digipres.xena.core.XenaMain -f /home/testing/Doco/supportedfiletypes/test.flac  -p plugins/ -o /home/Documents/xena_output/