General command line options

Run a profile:

pdfToolbox [-w] [-t] [-o=o] [-f=f] [-s=s] [--incremental] [-p=p] [--hitsperpage=hitsperpage] [--hitsperdoc=hitsperdoc] [--setvariable=setvariable] [-r=r] [-l=l] [--analyze] [--cachefolder=cachefolder] [--noprogress] [--nosummary] [--nohits] [--uncompressimg] [--timeout=timeout] <profile> <input file> [<input file> [...] ]

Run an action:

pdfToolbox <action> [--cachefolder=cachefolder] [-o=o] [-f=f] [-s=s] [--incremental] [-w] [-t] {action specific parameters} <input file> [<input file> [...] ]

Only process certain pages

-p --pagerange=<firstpage>[-<lastpage>]

Allows to define a pagerange to process when perfoming the following tasks:

  • Running a profile that contains only checks
  • Running the action --createeps
  • Running the action --saveasimg

Running a profile with the option --analyze also honors this option.


first page
first page to be processed
last page
last page to be processed

Setting the cache folder


Sets the cache folder path. This is set by default to:

%AppData%\callas software\callas pdfToolbox CLI 9
/Users/<USERNAME>/Library/Preferences/callas software/callas pdfToolbox CLI 9
<home directory as defined in /etc/passwd>/.callas software/callas pdfToolbox CLI 9

This option is mandatory when running the CLI as a user without a home directory.

The cachefolder should have sufficient read/write permissions for the executing user. Especially when the license file is only stored in the cachefolder, this file should be readable by other users.


absolute path to custom cache folder

Empty the profile cache

--emptyprofilecache [--cachefolder=<path>]

For performance reasons, bigger profiles are unpacked during first usage and containing ICC-profiles and config files are stored in a local profile cache. This command deletes this profile cache.

Empty the font cache

--emptyfontcache [--cachefolder=<path>]

For performance reasons, fonts found on the respective system are catalogized in an internal font cache. This command deletes this font cache.

Incremental saving


Allows to modify the input file, only writing the changes to the original PDF. This can increase the speed significantly since pdfToolbox CLI does not need to create a new copy of the file.

When using the action --impose together with option --preprocessingprofile

or the action --mergeimpose, the incremental saving option can be used in conjunction with --outputfile or --outputfolder to speed up the overall processing time, because all file modifications during these multi-step processes are then performed on a single temporary PDF file.

PDF structure and font optimization


The internal PDF structure and fonts are not optimized when saving the PDF file.

Enable processing PDF with password protection for editing and printing


To enable profile-processing of an password-protected PDF. Only PDFs with restrictions for editing and printing can be unsecured. The resulting PDF will have no security setting.

The entered password will be visible and may be grabbed or logged by
other processes on the machine.


password set to avoid editing or printing of the PDF

Defining an output file

-o --outputfile=<path>

Defines the absolute path of the destination file. The parent folder must exist.

Consult section "Results" to see if a new file was created. When running a profile containing checks only, no new output file is created.


absolute path to output file

Defining an output path

-f --outputfolder=<path>

Defines an absolute path to a folder where pdfToolbox CLI stores the resulting files of an execution.

If neither an output path nor an output folder is defined any result will be created next to the input file (filename will be indexed if necessary).

The use of --outputfile together with --outputfolder is not supported within one CLI call.


absolute path to output folder

Define the suffix

-s --suffix=<suffix>

Defines the suffix that will be appended to the resulting file(s) filename.

The defined suffix is added before the files type suffix (e.g. Output.pdf will become Output_PDFA.pdf when using --suffix=_PDFA).


string to append to filename

Overwrite mode

-w --overwrite

Overwrites existing files instead of indexing the filename.


-t --timestamp

Every line in the Standard output (stdout) is prefixed using a time stamp.

Font folders
If a font is not embedded and an embedding is required by a profile,
pdfToolbox CLI will search the system font directories in order to find the
needed font file, which are:

• /Users/<user>/Library/Fonts
• /Library/Fonts
• /System/Library/Fonts
Linux, Solaris Sparc, Solaris x86, AIX
• /usr/lib/X11/fonts
• /usr/local/X11R6/lib/X11/fonts
• /usr/share/fonts
• /<user home>/.fonts

Additionally the font folder installed together with pdfToolbox CLI will be searched. This folder lies next to the executable in "<callas pdfToolbox CLI directory>\etc\APDFL\Resource\Font".

ICC-profiles folders

The following folders are searched for required ICC-profiles, unless they are already contained in the .kfpx-profile already.

These folders lies next to the executable in:

  • "<callas pdfToolbox CLI directory>\etc\ICC profiles"
  • "<callas pdfToolbox CLI directory>\etc\APDFL\Resource\Color\Profiles"

Some system folders for colors are searched addtionally:

\Library\Application Support\Adobe\Color

Set a processing timeout


Sets the maximum processing time in seconds. If the process exceeds this duration, the execution process will be killed and the processing will result in an error.

Set path to referenced XObjects for PDF/X-5g, PDF/X-5pg and PDF/VT-2

--referencexobjectpath=<path to folder with resources>

Referenced, external resources of the PDF are searched in the same folder as the input PDF by default. To define another folder, this parameter can be used.


Send Your Comment

E-Mail me when someone replies to this comment