Chapter 14. Command-line tools

Table of Contents


DCP-o-matic includes some tools which allow DCP creation from the command line or from scripting languages. This chapter covers the use of those tools.

There are two command-line tools in DCP-o-matic. dcpomatic2_create creates film directories, with the associated metadata, from a list of content files. Then dcpomatic2_cli runs the transcode process on these film directories.

Some applications will benefit from setting up the films using the main DCP-o-matic GUI and then using dcpomatic2_cli to do the encode. This allows, for example, setup on a relatively low-powered machine before running the encode on a higher-powered headless server.


The syntax for dcpomatic2_create is:

dcpomatic2_create [OPTION] [CONTENT] [<CONTENT> ...]

[CONTENT] are the files or folders that you want to use in the DCP. They can be:

  • ‘Movie’ files in almost any common format (e.g. MP4, MOV, MKV, etc.)
  • A folder containing and image sequence in almost any common format (e.g. TIFF, DPX etc.)
  • Sound files (e.g. WAV, MP3, AIFF)
  • Subtitles files (e.g. .srt, DCP XML, .ssa etc.)

The options are:

  • -v, --version — show DCP-o-matic version
  • -h, --help — show this help
  • -n, --name — <name> film name
  • -t, --template <name> — template name
  • -c, --dcp-content-type <type> — FTR, SHR, TLR, TST, XSN, RTG, TSR, POL, PSA or ADV
  • --container-ratio <ratio> — 119, 133, 137, 138, 166, 178, 185 or 239
  • --content-ratio <ratio> — 119, 133, 137, 138, 166, 178, 185 or 239
  • -s, --still-length <n> — number of seconds that still content should last
  • --standard <standard> — SMPTE or interop (default SMPTE)
  • --no-use-isdcf-name> — do not use an ISDCF name; use the specified name unmodified
  • --no-sign— do not sign the DCP
  • -o, --output <dir> — output directory

For example, to setup a film using a MP4 file you might do:

dcpomatic2_create -o my_film --container-ratio 185 --content-ratio 185 -c FTR -n "My Film" Stuff.mp4

This will create a folder called my_film which is ready for a DCP to be made by dcpomatic2_cli.

dcpomatic2_create will use any default settings that you have configured in the main DCP-o-matic preferences.