Most of DCP-o-matic's configuration is stored in an XML file called
config.xml. This is stored in different places depending on your operating system:
Possible XML tags are as follows:
<Version>— The version number of the configuration file format; currently 2.
<MasterEncodingThreads>— Number of encoding threads to use when running as master.
<ServerEncodingThreads>— Number of encoding threads to use when running as server.
<DefaultDirectory>(optional) — Default directory when creating a new film in the GUI.
<ServerPortBase>— Port number to use for frame encoding requests.
ServerPortBase+ 1 and
ServerPortBase+ 2 are used for querying servers.
ServerPortBase+ 3 is used by the batch converter to listen for job requests.
<UseAnyServers>— 1 to broadcast to look for encoding servers to use, 0 to use only those configured.
<Server>(optional) — IP address or hostname of an encoding server to use; you can use as many of these tags as you like.
<OnlyServersEncode>— 1 to set the master to do decoding of source content no JPEG2000 encoding; all encoding is done by the encoding servers. 0 to set the master to do some encoding as well as coordinating the job.
<TMSProtocol>— Protocol to use to copy files to a TMS; 0 to use SCP, 1 for FTP.
<TMSIP>— IP address of TMS
<TMSPath>— Path on the TMS to copy files to
<TMSUser>— Username to log into the TMS with
<TMSPassword>— Password to log into the TMS with
<CinemaSoundProcessor>(optional) — Identifier of the type of cinema sound processor to use when calculating gain changes from fader positions. Currently can only be
<Language>(optional) — Language to use in the GUI e.g.
<DefaultContainer>(optional) — ID of default container to use when creating new films (
<DefaultScaleTo>(optional) — ID of default ratio to scale content to when creating new films (see
<DefaultDCPContentType>(optional) — Default content type ot use when creating new films (
<DefaultDCPAudioChannels>— Default number of audio channels to use when creating new films.
<DCPIssuer>— Issuer text to write into CPL files.
<DCPIssuer>— Creator text to write into CPL files.
<ISDCFMetadata>— Default ISDCF metadata to use for new films; child tags are
<DefaultStillLength>— Default length (in seconds) for still images in new films.
<DefaultJ2KBandwidth>— Default bitrate (in bits per second) for JPEG2000 data in new films.
<DefaultAudioDelay>— Default delay to apply to audio (positive moves audio later) in milliseconds.
<DefaultInterop>— 1 to default new films to Interop, 0 for SMPTE.
<DefaultKDMDirectory>(optional) — Default directory to write KDMs to.
<MailServer>— Hostname of SMTP server to use.
<MailPort>— Port number to use on SMTP server.
<MailUser>— Username to use on SMTP server.
<MailPassword>— Password to use on SMTP server.
<KDMSubject>— Subject to use for KDM emails.
<KDMFrom>— From address to use for KDM emails.
<KDMCC>— CC address to use for KDM emails; you can use as many of these tags as you like.
<KDMBCC>— BCC address to use for KDM emails
<KDMEmail>— Text of KDM email
<CheckForUpdates>— 1 to check dcpomatic.com for new versions, 0 to check only on request
<CheckForUpdates>— 1 to check dcpomatic.com for new text versions, 0 to check only on request
<MaximumJ2KBandwidth>— Maximum J2K bandwidth (in bits per second) that can be specified in the GUI
<AllowAnyDCPFrameRate>— 1 to allow users to specify any frame rate when creating DCPs, 0 to limit the GUI to standard rates
<LogTypes>— Types of logging to write; a bitfield where 1 is general notes, 2 warnings, 4 errors, 8 debug information related to encoding, 16 debug information related to encoding, 32 debug information for timing purposes, 64 debug information related to sending email.
<AnalyseEBUR128>— 1 to do EBUR128 analyses when analysing audio, otherwise 0.
<AutomaticAudioAnalysis>— 1 to run audio analysis automatically when audio content is added to the film, otherwise 0.
<Win32Console>— 1 to open a console when running on Windows, otherwise 0.
<Signer>— Certificate chain and private key to use when signing DCPs and KDMs. Should contain
<Certificate>tags in order and a
<PrivateKey>tag all containing PEM-encoded certificates or private keys as appropriate.
<Decryption>— Certificate chain and private key to use when decrypting KDMs
<History>— Filename of DCP to present in the File menu of the GUI; there can be more than one of these tags.
<DKDMGroup>— A group of DKDMs, each with a
Nameattribute, containing other
<DKDM>— A DKDM as XML
<CinemasFile>— Filename of cinemas list file
<ShowHintsBeforeMakeDCP>— 1 to show hints in the GUI before making a DCP, otherwise 0
<ConfirmKDMEmail>— 1 to confirm before sending KDM emails in the GUI, otherwise 0
<KDMFilenameFormat>— Format for KDM filenames
<KDMContainerNameFormat>— Format for KDM containers (directories or ZIP files)
<DCPMetadataFilenameFormat>— Format for DCP metadata filenames
<DCPAssetFilenameFormat>— Format for DCP asset filenames
<JumpToSelected>— 1 to make the GUI jump to the start of content when it is selected, otherwise 0
<Nagged>— 1 if a particular nag screen has been shown and should not be shown again, otherwise 0
<PreviewSound>— 1 to use sound in the GUI preview, otherwise 0
<PreviewSoundOutput>(optional) — Name of the audio output to use
<CoverSheet>— Text of the cover sheet to write when making DCPs