zint - Man Page

Encode data as a barcode image.


zint [ Options ] [ -d DATA ]


zint takes input data from file or directly from the user to encode in a barcode which is then output in a specified image file.

This manpage is a guide to the options available from the zint command line interface only.


General Information

-h,  --help

Print usage information summerising command line options.

-t,  --types

List symbol types and codes supported.

Input Control

-i,  --input=FILE

Obtain data from FILE (assumes UTF-8 encoding by default). Use a single hyphen (-) to capture from standard input.

-d,  --data=DATA

Process literal data given by DATA (assumes UTF-8 encoding by default).


Treat input data as GS1 encoded data with square brackets delimiting Application Indicators.


Treat input data literally. In most cases this assumes that input data is Latin-1 formatted.

General Processing Options

-b,  --barcode=BARCODE

Set the barcode standard which will be used to encode the data. BARCODE is a numerical representation as shown by the -t option.


Set the error correction level for the barcode symbol.


Use version NUMBER for creating QR Code symbols.


Set the primary message for Maxicode symbols or the main body data for composite symbols.


Set the encoding mode for Maxicode and composite symbols.


Add reader initialisation (FNC3) characters to Code 128 symbols.

Direct output data

-o,  --output=FILE

Write output image to FILE Image type is determined by file extension (.png, .svg or .eps).


Send output to standard output as a portable network graphic (PNG) image.


Send output to standard output as an encapsulated postscript (EPS) image.


Send output to standard output as a scalable vector graphic (SVG) image.


Output a textual representation of the generated image instead of outputting to file.

Adjust output image


Set height of adjustable height symbols to HEIGHT times of the x-dimension of the symbol.

-w,  --whitesp=NUMBER

Set the whitesapce (to the side of the symbol) to NUMBER times the x-dimension of the symbol.


Set the border width (on all sides of the symbol) to NUMBER times the x-dimension of the symbol.


Add a boundary box (in foreground colour) around the symbol.


Add boundary bars (in foreground colour) to the top and bottom of the symbol.

-r,  --reverse

Set colours to generate a white symbol on a black background.


Set the foreground (ink) colour. Input is given in six digit RRGGBB hexadecimal format.


Set the background (paper) colour. Input is given in six digit RRGGBB hexadecimal format.


Increase the size of the output image to NUMBER times the default width/height.


Rotate a PNG image by NUMBER degrees clockwise. Valid values are 0, 90, 180 and 270.


Set the number of columns of data, and hence the width, of certain types of symbol such as PDF417.


Override the default settings and supress inclusion of human readable text in the generated image.


Force Data Marix symbols to use square shaped symbols.

Input Formatting

When entering data using the -d option the following escape characters can be used:

\0 - Null

\E - End of Transmission

\a - Bell

\b - Backspace

\t - Horizontal Tab

\n - Line Feed

\v - Vertical Tab

\f - Form Feed

\r - Carriage Return

\e - Escape

\G - Group Separator

\R - Record Separator

Input which requires GS-1 formatting should use square brackets to separate Application Identifiers from the data. For example:



Please send bug reports to < zint-barcode@lists.sourceforge.net > rather than the project author so that they can be tracked properly.

See Also

Full documentation for zint and libzint are available from http://www.zint.org.uk


Robin Stuart <robin@zint.org.uk>


08 Oct 2010 version 2.4.1