Command line arguments

The main application cdbxpp.exe does only have one command line argument: You can only specify a file name of a CDBurnerXP compilation file to open it automatically.

However, the command line version of CDBurnerXP called cdbxpcmd.exe, located in the same program folder as the CDBurnerXP main application, has more useful options.

Syntax

The first argument specifies the main action. The following main actions exist, exactly one of them must be specified:

--list-drives    [lists all available drives]
--eject          [ejects the disc]
--load           [closes the tray]
--burn-data      [burns a data disc]
--burn-audio     [burns an audio disc]
--burn-video     [burns a DVD-video, requires v. 4.5 or later]
--burn-iso       [burns an ISO image]
--erase          [erases a disc]
--wait-for-disc  [waits until a disc has been inserted]

Except for –list-drives, all actions need at least one further argument, the -device parameter. The –list-drives action provides a list of all drives and the drive numbers to use. You can also use a drive letter.

Example:

--eject -device:0

The –burn-data and –burn-audio actions, take the following additional and (optional) arguments. The square brackets [ ] are part of the command, not indicating something optional.

-dao
Force burning in Disc at Once mode (data or audio discs). Only supported for CD-R/CD-RW (not DVD-R and others).
-tao (since v. 4.3)
Force burning in Track at Once mode (data or audio discs).
Use this option for multisession discs. Also use for burning discs other than CD-R/CD-RW.
-sao (since v. 4.3)
Force burning in Session at Once mode (data discs only). Only supported for CD-R/CD-RW (not DVD-R and others).
-close
Closes the disc after burning.
-eject
Ejects the disc after burning.
-file[\targetFolder]:sourcePath
-file:sourcePath (for audio and ISO)
Adds a file from sourcePath to the targetFolder on disc. You can add as many of these directives as you want. A path that contains spaces must be enclosed in double quotes.
-folder[\targetFolder]:sourcePath
-folder:sourcePath (for audio and video)
Adds a folder and all its contents to disc. You can add as many of these directives as you want. A path that contains spaces must be enclosed in double quotes. For DVD-video, specify the full path of the VIDEO_TS folder.
-speed:ratio (since 4.3.1, for example “24”, “8”, “4”)
Specifies the speed for burning the disc.
-sptd (since v. 4.3.8)
Uses the SPTD driver. May work more reliably, but requires installing the SPTD driver package before.

The –burn-data action takes the following additional arguments:

-import
Imports files on disc before adding more files
-name:NAME
Changes the disc's name to NAME (as it shows up in Windows Explorer). Maximum length: 16 chars.
-changefiledates (since v. 4.3.5)
If specified, all files on the disc will lose their original dates and have the date of the burning process.
-udf:VERSION (since v. 4.3.2, 1.02 is the default)
Changes the file system version. Options available: 1.02, 1.5, 2.0, 2.01, 2.5, 2.6.
-format:iso (since v. 4.5.1)
Instead of UDF, an ISO/Joliet file system is used for burning. The -udf flag does not apply then.
-verify (since v. 4.1.3)
Verifies the disc after burning.
-iso:PATH (since v. 4.1.3)
Instead of burning the disc, creates an ISO image at the specified path.
-layout:PATH (since v. 4.1.3)
Instead of adding files from the file and folder options, it loads all contents from a data compilation (DXP file).

Example:

--burn-data -device:0 -file[\]:c:\foo.db 
  -folder[\test]:c:\dell -name:foobar

The –burn-video action takes the following additional arguments (make sure to specify “-folder” as explained above):

-name:NAME
Changes the disc's name to NAME (as it shows up in Windows Explorer). Maximum length: 16 chars.
-iso:PATH (since v. 4.1.3)
Instead of burning the disc, creates an ISO image at the specified path.

Return codes / errors

If the desired action has been performed successfully, the application will return with exit code “0”. If any error occurs, a non-zero error code will be returned (check the full list of error codes for more information).

In case “-sptd” is used and the driver is not installed or could not be loaded successfully, -1 is returned.

Version requirement

This article applies to version 4.0.025 or higher.