PDF Filename
The output PDF filename. Not the full path, just the filename. e.g. When you go select the menu option "File | Save As" this is the default filename.   Sophisticated control codes and tags can be used, as described here
Backup location
If enabled, a copy of the generated PDF file is automatically placed into this directory. Sophisticated control codes and tags can be used, as described here.
Image Resolution (DPI) The resolution that images are 'down-sampled' to measured in dots per inch. Sometimes images are sampled at a high DPI for better results when printing to high-end printers. These high DPI sampled images result in larger PDF files. Screen resolution is 96 DPI, which is a good setting for PDF files intended solely for screen viewing.
JPEG Quality High quality results in larger PDF files, low quality smaller PDF files. "No JPEG" means JPEG compression is not used - "Flate" compression is used which is not "lossy" like JPEG.
Auto append When checked, PDFs are automatically appended to the currently open PDF in the pdfMachine viewer. If not checked, a separate viewer is launched for each print job.
Show Printing Status If enabled, the following dialog is displayed during the printing process:

Weekly online check If enabled, pdfMachine checks the Broadgun website once a week to see if a new version of pdfMachine has been released. If so, a message is displayed.
PDF/A-1b If enabled, files printed through pdfMachine will conform to the PDA/A-1b file format for long-term preservation.
Show Edit window after scanning If enabled, pdfScanMachine will launch pdfMachine with the Edit window open.
If not enabled, pdfScanMachine will launch pdfMachine  with the Viewer window open.
Colors Launches the color selection dialog for user interface color customization.
Upload anonymous usage data pdfMachine uses Google Analytics to help make the product better. If this option is checked then you are sharing your usage data to our Google analytic account, no personally identifying information is uploaded. Just events like which buttons were clicked, what menu options were chosen. This helps us know what features our customers use most often.

Output Filename

The resulting PDF file can be named using sophisticated tags and control characters to include things as timestamps, auto incrementing numbers and environment variables.

The time stamping follows the syntax of the C programming function strftime.

Time stamping codes
The formatting codes for strftime are listed below:

Abbreviated weekday name

Full weekday name

Abbreviated month name

Full month name

Date and time representation appropriate for locale

Day of month as decimal number (01 – 31)

Hour in 24-hour format (00 – 23)

Hour in 12-hour format (01 – 12)

Day of year as decimal number (001 – 366)

Month as decimal number (01 – 12)

Minute as decimal number (00 – 59)

Current locale's A.M./P.M. indicator for 12-hour clock

Second as decimal number (00 – 59)

Week of year as decimal number, with Sunday as first day of week (00 – 53)

Weekday as decimal number (0 – 6; Sunday is 0)

Week of year as decimal number, with Monday as first day of week (00 – 53)

Date representation for current locale

Time representation for current locale

Year without century, as decimal number (00 – 99)

Year with century, as decimal number

%z, %Z
Either the time-zone name or time zone abbreviation, depending on registry settings; no characters if time zone is unknown

Percent sign

Auto Incrementing Numbers (e.g. Bates numbering)


These tags are dynamically substituted with a variable that is automatically increment upon each use.

The number after the AUTONUM refers to the field size of the number, i.e. how many digits make up the number, including leading zeros.

e.g. If the output filename is "tmp_{AUTONUM}.pdf" then the first time the file will be "tmp_0.pdf" and the second time it will be "tmp_1.pdf" and so on. 

Document Name


This tag is dynamically substituted with the print job name. The print job name is set by the application that is doing the printing but is usually derived from the document file name.


This tag is similar to DOC_FULL, except this tag also strips out all characters prior to the first '-' character. It also strips out all characters after the last '.' character.

This can be handy if a long prefix is on all print job names of a particular application. It is also handy to remove the "Microsoft Word - " prefix and the ".docx" suffix on Word print jobs.


This tag is similar to DOC_FULL, except this tag also strips out all characters after the last '.' character.

This can be handy if the print job names include the type of file as a suffix eg ".xlxs" and you don't want your PDF to have the suffix '.xlsx.pdf'.

For example, if a print job has the job name "Microsoft Word - document1.docx"

A tag of {DOC_FULL} will result in a filename of "Microsoft Word - document1.docx.pdf"

A tag of {DOC} will result in a filename of "document1.pdf"

A tag of {DOC_NOSUFFIX} will result in a filename of "Microsoft Word - document1.pdf"

Environment Variable Substitution

Any Windows environment variable can be used inside of the curly braces and the value is dynamically substituted to create a filename.

e.g. if the output filename is set to "{USERNAME}.pdf" and the user "Fred" is logged on then the filename will be "Fred.pdf".

Example 1

The default output filename for scanning is:

%Y-%m-%d %H-%M-%S scan by {USERNAME} - {AUTONUM5}.pdf

If the user Fred is logged on the first scanned document will have a name of:

2009-03-29 13-31-35 scan by Fred - 00000.pdf

Example 2

%Y-%m-%d %H-%M-%S {DOC}.pdf

If the document named "readme.doc" was printed to pdfMachine, this would result in a PDF named:

2011-03-29 13-31-35 readme.pdf