2Printer Command Line Syntax

Default value: 1

Example:

2printer.exe -src "C:\In\*.*" -prn "MFP LaserJet" -props copies:3

Values:
default (default value), simplex, vertical, horizontal

Double-sided (duplex) printing allows you to print on both sides of paper sheets. If your printer supports duplex printing – this might be a useful feature. By default, 2Printer uses the same duplex mode settings as those defined in your printer preferences. In 2Printer, you can set up vertical or horizontal duplex printing for your documents.

You can switch to simplex mode (one-sided printing) by using the duplex:simplex value. Or set duplex:default – to use printer preferences.

Example:

Values:
asinprinter (default value), color, grayscale, asindocument

Prints all documents in grayscale or color mode.

For instance, you can set -props color:asindocument to print pages in their original color. The program will choose either color or grayscale (black-and-white) mode for each page – depending on their contents. The actual printing will be based on the page's color or absence of color. If at least one pixel of the original file has color, the whole page will be considered as colored and thus printed in color.

Learn how to set color mode by default in Advanced Settings →

Examples:

Values:
portrait, landscape, asindocument (default value), asinprinter

The default page orientation value is as set in the document. To print all documents in portrait or landscape orientation, use these commands:

Portrait orientation:

Landscape orientation:

Here you can also select other options:

• orient:asindocument – use the original document's page orientation;
• orient:asinprinter – use the same settings for orientation as in printer.

Values:
direct (default value), reverse

Switches to direct or reverse page order. You can change the pages' printing order to reverse when printing multipage documents.

Example:

Unique values:

"-1" – As in printer (paper size as set in your printer's printing preferences). 

"-2" – Page size based. When Page size based is selected, the program identifies the page size dimensions of a document. It chooses the best paper format that would match the page at a scale of 1:1 without large margins around the page. If a perfect match is not possible, then the closest possible option is used.

You can also use a specific paper size. Use this command to check the ID number of all available paper sizes.

Example:

Default value: all

Defines numbers of pages to be printed.

To select pages from the end of the document, use the expression "last" (last for the last page, last1 for the penultimate page, etc.). For example: 1,5,last2,last1,last

Example:

Values:
shrink (default value), fit, original, fill, booklet, zoom

Example:

Default value: 100

Example:

Default value: as set in printer preferences

Uses a specific printer tray. Enter tray name or ID to use a specific printer tray. You can view a list of available trays in advance.

Example:

Default value: none

Sets a certain printer tray for selected pages. That means you can select different paper sources for specific page ranges.

Example:

Values:
ignore, after (default value), before, only

If you print documents that contain attachments, you can select a way how 2Printer should handle them:

• ignore – ignore attachments
• after – print attachment after a document
• before – print attachment before a document
• only – print attachments only

This can be useful when batch printing, e.g., correspondence with email attachments, PDF Portfolio files, and other files with attachments.

Example:

Values:
no (default value), yes

To ensure that files are printed in order, use the Single print job mode. This mode prints the files as a single batch, maintaining the specified order. The files will be sent to the printer from top to bottom as they appear in your list, whether it’s a text file or a list within a folder.

2Printer.exe -src "@C:\Input\docs.txt" -prn "MFP LaserJet" -props spjob:yes

Default value: "2Printer's single print job"

You can define the single print job's name:

The name appears in the print queue (spooler) on the computer and on the printer display. It may be convenient to see what's being printed. And it's easy to identify which job is having issues in case of an error.

Besides, if you're printing to a virtual printer, the name of the output file(s) usually matches the print job's name.

Besides plain text, you may want to use macros here. For example:

Values:
left, center (default value), right

Aligns the prints' position in the center, or left/right side of a sheet. Can be combined with other alignment and offset parameters.

Example:

Values:
top, center (default value), bottom

Aligns the prints' position vertically in the top, center, or bottom of a sheet. Can be combined with other alignment and offset parameters.

Example:

Default value: 0

Shifts the prints' position horizontally by setting a specific value, in points (1/100 inch). Can be combined with other alignment and offset parameters.

Example:

Default value: 0

Shifts the prints' position vertically by setting a specific value, in points (1/100 inch). Can be combined with other alignment and offset parameters.

Example:

Values:
no (default value), yes

Scans subdirectories and print files from them too (subfolder recursion).

Example:

Allows printing of password-protected Word and PDF files. Enter a password in this format: srcpwd:password.

If a password contains spaces, input it between double quotation marks.

Example: srcpwd:"my password".

If you have files secured with more than one password, you can enter multiple passwords too.
Example: srcpwd:password1 srcpwd:password2 srcpwd:password3.

Example:

Values (value in bold is default):
no (default value), yes

Stops the program in case of an error.

Example:

You can keep a log of files that failed to print for some reason. You'll need to use -options unprinted_files_log and set a path to a file that should be created for the log file. Just specify a destination to a text file.

Example:

Values (value in bold is default):
unsorted, name, date, type, size, path, name_d, date_d, type_d, size_d, path_d

You can sort files by specific parameters, such as name, date, type, size, path. To sort the files in descending order, use values ending with _d (name_d, date_d, etc.).

Runs a script (e.g., a BAT file) before printing the next file.

Example:

Adds parameters to the script (runscript), such as username or other parameters.

Example:

2Printer -src "C:\In\*.*" -prn "MFP LaserJet" -options -stat report_folder:"C:\Out" -options runscript:"C:\Data\Clear_printer_buffer.bat" script_params:"Username"

Displays a list of all available printers and their names. When using other commands, input a printer's name exactly as you see in this list, within double quotation marks.

Execute command:

Displays a list of available local or network printers. When using other commands, input a printer's name exactly as you see in this list, within double quotation marks.

Execute command:

2Printer.exe -options showprnlist2

Displays a list of available printer trays. Can show trays of all devices or a selected printer only. When printing, you can use the ID number or name of a specific tray, for example: 2Printer.exe -src "C:\In\*.*" -prn iR C3025" -props tray:1.

To view all printers' names and trays sublist for each printer:

For instance, here's a command to print on a Multi-purpose Tray of a Canon printer (as on the screenshot above):

Note: When specifying a tray name, you can either use its name (-props tray:"Drawer 1") or its ID number, without quotation marks (-props tray:1).

Displays a list of all available paper sizes. To view paper sizes of a certain printer only, add -prn and the printer's name to the command:

For example, the following command prints all documents in a folder "C:\In" in Legal paper size format:

Sends a request to a specific printer and checks its status. The printer's status will be "online" if it's turned on and available, or "offline" if it's turned off or unavailable.

Values:
yes (default value), no

Saves log files (in XML format) containing information about the system and records of all 2Printer events. We recommend having this parameter activated because information contained in log files will help 2Printer developers quickly figure out what's happening in case of any error or issue.

Default value: %TEMP%

Sets path to a folder for log files. By default, it is %TEMP% which usually opens the path "C:\Users\[User]\AppData\Local\Temp".

Default value: verbose

Select the type of log created by 2Printer: Verbose, Regular, Laconic, or Trace.

2Printer.exe -src "C:\In\*.*" -prn "iR C3025" -options log:yes logpath:"E:\2Printer Logs" logverbosity:regular

Default value: none

Create a plain text summary showing which files were printed successfully and which ones failed.

2Printer.exe -src "C:\In\*.*" -prn "iR C3025" -options pres:"C:\My folder\My_log.txt"

Default value: none

Specify a path to export a ZIP file containing the current 2Printer settings ("2Printer.ini") and recent log files. This archive can be attached when contacting our support team to help diagnose issues.

2Printer.exe -src "C:\In\*.*" -prn "iR C3025" -options export_path:"C:\My folder\Logs and Settings"

Values (value in bold is default):
no, yes

Prints all documents in fully automatic and silent mode. The information on console window will not be displayed during processing and no dialog windows will appear:

Values (value in bold is default):
no, yes

Displays alert windows in case of an error or issue. If set to "no", you will not get any dialog windows, such as asking to register the program's license or to print an additional cover page (if the trial version is used). However, the information on console window will be displayed during processing:

Uses your username (login) if password entry is required to access the web page you want to print (URL is set as a source). Don't forget to specify both credentials – user and password.

Uses your password if password entry is required to access the web page you want to print (URL is set as a source). Don't forget to specify both credentials – user and password.

Tip: Note: If your username or password contains spaces, try enclosing them in double quotation marks.

Values:
no (default value), yes

Enables printing cover page between each file. Switch it to yes and specify the type of cover page using the template parameter.

Example:

Uses a built-in cover page template or a custom cover page in HTML format. To set a custom cover page, add a path to it starting with '@'.

What built-in templates are available? You can find the full list at 2Printer Settings (2Printer.exe -ini) > Common > Service pages > Print cover page. Then type the name of a desired template in the command line. Example: -spops cover:yes template:"Filename with app logo".

Example command for built-in cover page template:

Example command for custom cover page:

Values:
no (default value), yes

Prints several pages of a multipage document on a single sheet of paper.

Example:

Default value: 1

Sets the number of pages to be placed horizontally.

Example:

Default value: 1

Sets the number of pages to be placed vertically.

Example:

Default value: Yes

In Multiple pages per sheet mode, 2Printer starts printing each new document on a new sheet of paper by default.

If you want to print multiple documents (files) on a single sheet of paper without “page breaks”, disable this option Start next document on a new sheet of paper. The remaining empty space on the current sheet of paper (if any) will be used to start placing a new document (file). This will allow you to place several documents (files) on one sheet of paper and print them compactly.

Values (value in bold is default):
none, copy, move, delete

Selects action to be performed with successfully printed files: do nothing, copy/move to another folder, or delete.

Example:

Specifies a folder where successfully printed files should be moved or copied.

Example:

Values:
{*SrcFileName}.{*SrcFileExt}

Allows to adjust the filename for the source files that were successfully processed.
Learn more →

Example:

Values:
no (default value), yes

Deletes empty subfolders that are no longer needed after successfully printed files were moved or deleted from there.

To use this feature, make sure to enable scanning subfolders (-options scansf:yes) and set passed_delsf and/or failed_delsf parameters to yes. A "subfolder" here means any nested folder inside the specified source location (for example, C:\In\Subfolder_A in the example below).

Example:

Values (value in bold is default):
none, copy, move, delete

Selects action to be performed with files that were not printed: do nothing, copy/move to another folder, or delete.

Example:

Values (value in bold is default):
none, copy, move, delete

Specifies a folder where failed files should be moved or copied.

Example:

Values:
{*SrcFileName}.{*SrcFileExt}

Allows to adjust the filename for the source files that failed to print.
Learn more →

Example:

Values:
no (default value), yes

Deletes empty subfolders after failed files were moved or deleted from there.

Example:

Default value: 0

Sets custom page width for source HTML files.

Example:

2Printer.exe -src "C:\In\*.*" -prn "MFP LaserJet" -fls html width:500 height:300

Default value: 0

Sets custom page height for source HTML files.

Example:

2Printer.exe -src "C:\In\*.*" -prn "MFP LaserJet" -fls html width:500 height:300

Values:
inch (default value), mm, cm

Switch between inches, millimeters, and centimeters to specify the page size of source HTML files.

Example:

2Printer.exe -src "C:\In\*.*" -prn "MFP LaserJet" -fls html width:500 height:300 units:mm

Sets path to a folder for saving the report (an XML file).

Example:

2Printer.exe -src "C:\In\*.*" -prn "MFP LaserJet" -stat report_folder:"C:\2Printer reports"

Default value: all

Sets pages where the watermark should be applied. Example: "1,3-5,12". By default, it is applied to all pages.

To select pages from the end of the document, use the expression "last" (last for the last page, last1 for the penultimate page, etc.). For example: 1,5,last2,last1,last

Example:

2Printer.exe -src "C:\In\*.*" -prn "MFP LaserJet" -oper watermark image:"C:\Watermark.png" pages:"1,2"

Sets path to the file to be used as a watermark. Example: "C:\Watermark.png"

Example:

Values:
left (default value), center, right

Aligns image watermark horizontally: to the left, center, or right side of a sheet. Can be combined with other alignment and offset parameters.

Example:

Values:
top (default value), center, bottom

Aligns image watermark vertically: to the left, center, or right side of a sheet. Can be combined with other alignment and offset parameters.

Example:

Default value: 0

Shifts the pages' position horizontally using a specific value (in percent of the page width). Can be combined with other alignment and offset parameters.

Example:

Default value: 0

Shifts the pages' position vertically using a specific value (in percent of the page width). Can be combined with other alignment and offset parameters.

Example:

Default value: -1 (original size)

Sets watermark size as percent of source file's page height and width. For example, enter size:15 for 15%. -1 is the default value, which applies the watermark "as is" using its original size.

Example:

Default value: 0

Rotates the watermark at a specific angle. The rotation is clockwise by default, but you can switch it to counterclockwise.

Example:

Values:
cw (default value), ccw

You can select clockwise (cw) or counterclockwise (ccw) direction for watermark rotation.

Example:

Values:
alphablend (default value), overdraw

Uses a blending method when applying a watermark – AlphaBlend or Overdraw.

Example:

Values:
foreground (default value), background

Places the watermark behind (background) or in front (foreground) of the document's contents.

Example:

You can input any text within double quotation marks.

Example:

Default value: Arial

Applies a specific font for text watermark.

Example:

Default value: 12

Sets font size value (in points or percents) for text watermark.

Example:

Values:
points (default value), percents

Switches between points and percent (percent of image height) when specifying font size.

Example:

Values:
no (default value), yes

Uses a bold font style for the text watermark.

Example:

Values:
no (default value), yes

Uses an italic font style for the text watermark.

Example:

Values:
no (default value), yes

Uses an underline font style for the text watermark.

Example:

Values:
left (default value), center, right

Aligns text watermark horizontally: to the left, center, or right side of a sheet. Can be combined with other alignment and offset parameters.

Example:

Values:
top (default value), center, right

Aligns text watermark vertically: to the top, center, or bottom of a sheet. Can be combined with other alignment and offset parameters.

Example:

Default value: 0

Shifts the watermark's position horizontally using a specific value (in percent of the page width). Can be combined with other alignment and offset parameters.

Example:

Default value: 0

Shifts the watermark's position vertically using a specific value (in percent of the page height). Can be combined with other alignment and offset parameters.

Example:

Default value: "r:0,g:0,b:0,a:255"

Applies text color using RGBA color model –
"r:(0-255),g:(0-255),b:(0-255);a:(0-255)".

Example:

Default value: "r:255,g:255,b:255,a:255"

Applies color behind the text using RGBA color model –
"r:(0-255),g:(0-255),b:(0-255);a:(0-255)".

Example:

Default value: 0

Rotates the text watermark at a specific angle. You can select any arbitrary angle.

Example:

Values:
cw (default value), ccw

Sets direction for text watermark rotation – clockwise (cw) or counterclockwise (ccw).

Example:

Values:
no (default value), yes

Adds a border around the text watermark.

Example:

Values:
foreground (default value), background

Places the watermark behind (background) or in front (foreground) of the document's contents (positioning by Z-axis).

Example:

Default value: all

Defines the range of pages which must be resized, e.g., pages:1,3,5-12. If not specified, resizing is applied to every page.

To select pages from the end of the document, use the expression "last" (last for the last page, last1 for the penultimate page, etc.). For example: 1,5,last2,last1,last

Example:

Default value: "0 0"

Defines width and height dimensions (in pixels) for file resizing. The source file proportions are kept.

Example:

Values:
pixels (default value), percents

Uses pixels or percents as units for resize operation.

Example:

Values:
fit_in_size (default value), thumbnail, fit_width, fit_height, fill_in_size, none

Applies page scaling to fit a specific size. Available values:

• fit_in_size – Fit the size specified for the size: parameter. Oversized images will be shrunk to the defined width and height, and small ones will be enlarged to fit the page size;
• thumbnail – Fit the size of a thumbnail;
• fill_in_size – Fill the size specified for the size: parameter. The image will be positioned on the entire sheet by the smaller side (the longer side may go beyond the defined area);
• fit_width – Fit the size specified for the size: parameter by width;
• fit_height – Fit the size specified for the size: parameter by height.

Example:

Values:
center (default value), left_top, right_bottom

Aligns the resized image to the center, left top corner, or right bottom corner.

Example:

Values:
no (default value), yes

Prevents image upscaling to avoid quality loss.

Example:

Values:
bilinear (default value), neighbour

Applies the nearest neighbor or bilinear interpolation resampling method for image resizing.

Example:

Default value: "r:255,g:255,b:255,a:255"

Fills blank margins around the resized image (if they appear) with a certain color using RGBA color model – "r:(0-255),g:(0-255),b:(0-255);a:(0-255)".

Example:

Default value: all

Defines the range of pages which must be cropped, e.g., pages:1,3,5-12. If not specified, the operation is applied to every page.

To select pages from the end of the document, use the expression "last" (last for the last page, last1 for the penultimate page, etc.). For example: 1,5,last2,last1,last

Example:

2Printer.exe -src "C:\In\*.*" -prn "MFP LaserJet" -oper crop pages:"1,3,5-10" method:autocrop

Values:
margins (default value), rect2p, rect_pwh, autocrop

Applies a specific image cropping method.

Example:

Default value: "0"

Sets the left margin, in pixels. Applies to margins and rect2p crop methods.

Example:

Default value: "0"

Sets the top margin, in pixels. Applies to margins and rect2p crop methods.

Example:

Default value: "0"

Sets the right margin, in pixels. Applies to margins and rect2p crop methods.

Example:

Default value: "0"

Sets the bottom margin, in pixels. Applies to margins and rect2p crop methods.

Example:

Default value: "0"

Sets the crop width for the rect_pwh crop method, in pixels.

Example:

Default value: "0"

Sets the crop height for rect_pwh cropping method, in pixels.

Example:

Default value: "r:255,g:255,b:255,a:255"

Applies color code for the autocrop method using RGBA color model –
"r:(0-255),g:(0-255),b:(0-255);a:(0-255)".

Example:

Default value: "0"

Applies tolerance value for autocrop method (0-100%). Tolerance parameter specifies the allowed deviation from the color sample specified in the previous color parameter.

Example:

Default value: percents

Specifies the measurement units used for the Crop operation: pixels, millimeters (mm), centimeters (cm), or percentages.

Example:

Default value: all

Defines the range of pages which must be rotated, e.g., pages:1,3,5-12. If not specified, rotation is applied to every page.

To select pages from the end of the document, use the expression "last" (last for the last page, last1 for the penultimate page, etc.). For example: 1,5,last2,last1,last

Example:

Default value: 0

Rotates the document or image to a certain degree (0-360°). The rotation is clockwise by default.

Example:

Values:
cw (default value), ccw

You can select clockwise (cw) or counterclockwise (ccw) direction for pages' or images' rotation.

Example:

Default value: "r:255,g:255,b:255,a:255"

Fills blank margins around the rotated image (if they appear) with a certain color using RGBA color model – "r:(0-255),g:(0-255),b:(0-255);a:(0-255)".

Example:

Default value: all

Sets pages where the barcode should be applied. Example: "1,3-5,12". By default, it is applied to all pages.

To select pages from the end of the document, use the expression "last" (last for the last page, last1 for the penultimate page, etc.). For example: 1,5,last2,last1,last

Example:

Default value: none

Enter the barcode code or text for it. For example, if you're adding a QR code, simply enter your text (or a hyperlink) here.

Example:

Default value: none

You can apply various types of barcodes, including QR Code, Code 128, EAN, UPC, Data Matrix, and others.

The full list of supported barcode types includes:
code_128, aztec, codabar, code_39, code_93, data_matrix, ean_8, ean_13, itf, maxicode, pdf_417, qr_code, rss_14, rss_expanded, upc_a, upc_e, all_1d, upc_ean_extension, msi, plessey, imb, and pharma_code.

Example:

Default value: Arial

If the barcode displays text, you can choose a font for the Barcode operation. Any font installed on your Windows system can be used.

Example:

Default value: 5

Set the font size for the Barcode operation as a percentage (%) of the barcode height.

Example:

Default value: no

Makes font for the barcode semi-bold.

Example:

Default value: no

Makes font for the barcode italic.

Example:

Default value: no

Makes font for the barcode underlined.

Example:

Default value: no

GS1 barcodes are standardized barcode formats that encode product identifiers, such as the Global Trade Item Number (GTIN). They ensure global uniqueness and interoperability, so products can be scanned and identified consistently across retailers, warehouses, and countries.

Example:

Default value: yes

Show or hide barcode textual contents on the output.

Example:

Default value: 20

Set the barcode size as a percentage of the page's width and height.

Example:

Default value: 300

Set the width-to-height ratio of the barcode along the X-axis (width). Use together with the aspy parameter.

Example:

Default value: 300

Set the width-to-height ratio of the barcode along the Y-axis (height). Use together with the aspx parameter.

Example:

Default value: left

Aligns the barcode horizontally: to the left, center, or right side of a sheet. Can be combined with other alignment and offset parameters. Use together with the valign parameter.

Example:

Default value: top

Aligns the barcode vertically: to the top, center, or bottom of a sheet. Can be combined with other alignment and offset parameters. Use together with the 'halign' parameter.

Example:

Default value: 0

Sets the horizontal offset for the barcode as a percentage of the page width. This shifts the barcode’s position along the X-axis. Can be used together with alignment settings and the 'offy' parameter for precise placement.

Example:

Default value: 0

Set the vertical offset for the barcode as a percentage of the page height. This moves the barcode along the Y-axis. Can be used with alignment settings and the 'offx' parameter for accurate positioning.

Example:

Default value: "r:0,g:0,b:0,a:255"

Applies text color using RGBA color model –
"r:(0-255),g:(0-255),b:(0-255);a:(0-255)".

Example:

Default value: "r:255,g:255,b:255,a:255"

Applies text color using RGBA color model –
"r:(0-255),g:(0-255),b:(0-255);a:(0-255)".

Example:

Default value: "r:255,g:255,b:255,a:255"

Adds a border around the barcode.

Example: