qrencode man page

qrencode — Encode input data in a QR Code and save as a PNG or EPS image.


qrencode [OPTION]... [STRING]


Libqrencode is a library for encoding data in a QR Code symbol, a kind of 2D symbology that can be scanned by handy terminals such as a mobile phone with CCD. The capacity of QR Code is up to 7000 digits or 4000 characters, and has high robustness.

Qrencode is a utility software using libqrencode to encode string data in a QR Code and save as a PNG or EPS image.


-h, --help

display help message.


write image to FILENAME. If '-' is specified, the result will be output to standard output. If -S is given, structured symbols are written to FILENAME-01.png, FILENAME-02.png, ... (suffix is removed from FILENAME, if specified)

-s NUMBER, --size=NUMBER

specify the size of dot (pixel). (default=3)

-l {LMQH}, --level={LMQH}

specify error collectin level from L (lowest) to H (highest). (default=L)

-v NUMBER, --symversion=NUMBER

specify the version of the symbol. See Symbol Versions for more information. (default=auto)

-m NUMBER, --margin=NUMBER

specify the width of margin. (default=4)


specify the DPI of the generated PNG. (default=72)


specify the type of the generated image. (default=PNG)

-S, --structured

make structured symbols. Version must be specified.

-k, --kanji

assume that the input text contains kanji (shift-jis).

-c, --casesensitive

encode lower-case alphabet characters in 8-bit mode. (default)

-i, --ignorecase

ignore case distinctions and use only upper-case characters.

-8, --8bit

encode entire data in 8-bit mode. -k, -c and -i will be ignored.

-M, --micro

encode in a Micro QR Code. (experimental)


specify foreground/background color in hexadecimal notation. 6-digit (RGB) or 8-digit (RGBA) form are supported. Color output support available only in PNG and SVG.

-V, --version

display the version number and copyrights of the qrencode.


display verbose information to stderr.


input data. If it is not specified, data will be taken from standard input.

Symbol Versions

The symbol versions of QR Code range from Version 1 to Version 40. Each version has a different module configuration or number of modules, ranging from Version 1 (21 x 21 modules) up to Version 40 (177 x 177 modules). Each higher version number comprises 4 additional modules per side by default. See http://www.qrcode.com/en/about/version.html for a detailed version list.


qrencode -l L -v 1 -o output.png 'Hello, world!'

encode into a symbol version 1, level L.

qrencode -iSv 1 --output=output.png

read standard input and encode it into a structured-appended symbols in case-insensitive mode.

cat bigfile.txt | qrencode -S -v 40 -l L -o output.png

encode into a symbol version 40, level L.


Written by Kentaro Fukuchi.


Main Web Site: http://fukuchi.org/works/qrencode/

Source code repository: https://github.com/fukuchi/libqrencode/

Referenced By

gpg-key2latex(1), pass(1).

Oct. 9, 2012 qrencode 3.4.4