4.5

Table Of Contents
177Compressor User Guide
Use the command line to submit Compressor jobs
Intro to shell commands in Compressor
If you’re accustomed to doing your work from Terminal shells, you can run the Compressor
application from the command line using the Compressor command. There are a number
of command-line options for submitting jobs.
In the command-line descriptions in this section, angle brackets < > indicate a mandatory
argument in a command, and brackets [ ] indicate an optional argument.
Job command syntax in Compressor
Below is a synopsis of the Compressor command for submitting a job to a cluster. The
Compressor command is located in <PATH>/Compressor.app/Contents/MacOS.
Important: The command below must be executed on one line.
Compressor [-computergroup <name>] [-batchname <name>]
[-priority <value>] -jobpath <file>[?frameRate=<frame rate>
|?audio=<file>|?frameRate=<frame rate>\&audio=<file>]
-settingpath <setting> -locationpath <file>
[-info <xml>] [-scc <file>] [-startoffset <hh:mm:ss:ff>]
[-in <hh:mm:ss:ff> [-out <hh:mm:ss:ff> [-annotations <file>]
[-chapters <file>]
Compressor -checkstream <file>
Compressor -findletterbox <file>
Compressor -help
Compressor [-resetBackgroundProcessing [cancelJobs]]
[-sharing <on|off>] [[-requiresPassword <password>]
| [-noPassword]] [-instances <value>]
[-networkInterface <bsd name>] [-portRange <starting port>
<count>]
These three arguments are the minimum required to submit a batch:
Compressor -jobpath <path> -settingpath <path> -locationpath <path>
Common command options used with Compressor
This table shows the most used command options for submitting jobs in Compressor:
Submission command option Description
-computergroup <name> Specifies the name of the group of shared computers.
-batchname <name> Specifies the name of the batch.
-priority <value> Specifies the priority level for a job.
-jobpath <url> Specifies the location of the source file.