Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

Download
ActivePython
INSTALL>
pypm install qrcode

How to install qrcode

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install qrcode
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
2.4.1
4.0.1Never BuiltWhy not?
2.4.1 Available View build log
2.3.1 Available View build log
2.3 Available View build log
2.0 Available View build log
1.0 Available View build log
Windows (64-bit)
2.4.1
4.0.1Never BuiltWhy not?
2.4.1 Available View build log
2.3.1 Available View build log
2.3 Available View build log
2.0 Available View build log
1.0 Available View build log
Mac OS X (10.5+)
2.7
4.0.1Never BuiltWhy not?
2.7 Available View build log
2.4.1 Available View build log
2.3.1 Available View build log
2.3 Available View build log
2.0 Available View build log
1.0 Available View build log
Linux (32-bit)
3.1.1
4.0.1Never BuiltWhy not?
3.1.1 Available View build log
2.7 Available View build log
2.4.2 Available View build log
2.4.1 Available View build log
2.3.1 Available View build log
2.3 Available View build log
2.0 Available View build log
1.0 Available View build log
Linux (64-bit)
4.0.1 Available View build log
4.0 Available View build log
3.1.1 Available View build log
2.7 Available View build log
2.4.2 Available View build log
2.4.1 Available View build log
2.3.1 Available View build log
2.3 Available View build log
2.0 Available View build log
1.0 Available View build log
4.0.1 Available View build log
4.0 Available View build log
 
Author
License
BSD
Lastest release
version 4.0.1 on Sep 20th, 2013

This module uses image libraries, Python Imaging Library (PIL) by default, to allow for the generation of QR Codes.

What is a QR Code?

A Quick Response code is a two-dimensional pictographic code used for its fast readability and comparatively large storage capacity. The code consists of black modules arranged in a square pattern on a white background. The information encoded can be made up of any kind of data (e.g., binary, alphanumeric, or Kanji symbols)

Usage

From the command line, use the installed qr script:

qr "Some text" > test.png

Or in Python, use the make shortcut function:

import qrcode
img = qrcode.make('Some data here')
Advanced Usage

For more control, use the QRCode class. For example:

import qrcode
qr = qrcode.QRCode(
    version=1,
    error_correction=qrcode.constants.ERROR_CORRECT_L,
    box_size=10,
    border=4,
)
qr.add_data('Some data')
qr.make(fit=True)

img = qr.make_image()

The version parameter is an integer from 1 to 40 that controls the size of the QR Code (the smallest, version 1, is a 21x21 matrix). Set to None and use the fit parameter when making the code to determine this automatically.

The error_correction parameter controls the error correction used for the QR Code. The following four constants are made available on the qrcode package:

ERROR_CORRECT_L
About 7% or less errors can be corrected.
ERROR_CORRECT_M (default)
About 15% or less errors can be corrected.
ERROR_CORRECT_Q
About 25% or less errors can be corrected.
ERROR_CORRECT_H.
About 30% or less errors can be corrected.

The box_size parameter controls how many pixels each "box" of the QR code is.

The border parameter controls how many boxes thick the border should be (the default is 4, which is the minimum according to the specs).

Other image factories

You can encode as SVG, or use a new pure Python image processor to encode to PNG images.

The Python examples below use the make shortcut. The same image_factory keyword argument is a valid option for the QRCode class for more advanced usage.

SVG

On Python 2.6 must install lxml since the older xml.etree.ElementTree version can not be used to create SVG images.

You can create the entire SVG or an SVG fragment. When building an entire SVG image, you can use the factory that combines as a path (recommended, and default for the script) or a factory that creates a simple set of rectangles.

From your command line:

qr --factory=svg-path "Some text" > test.svg
qr --factory=svg "Some text" > test.svg
qr --factory=svg-fragment "Some text" > test.svg

Or in Python:

import qrcode
import qrcode.image.svg

if method == 'basic':
    # Simple factory, just a set of rects.
    factory = qrcode.image.svg.SvgImage
elif method == 'fragment':
    # Fragment factory (also just a set of rects)
    factory = qrcode.image.svg.SvgFragmentImage
else:
    # Combined path factory, fixes white space that may occur when zooming
    factory = qrcode.image.svg.SvgPathImage

img = qrcode.make('Some data here', image_factory=factory)

Two other related factories are available that work the same, but also fill the background of the SVG with white:

qrcode.image.svg.SvgFillImage
qrcode.image.svg.SvgPathFillImage
Pure Python PNG

Install the following two packages:

pip install git+git://github.com/ojii/pymaging.git#egg=pymaging
pip install git+git://github.com/ojii/pymaging-png.git#egg=pymaging-png

From your command line:

qr --factory=pymaging "Some text" > test.png

Or in Python:

import qrcode
from qrcode.image.pure import PymagingImage
img = qrcode.make('Some data here', image_factory=PymagingImage)

Subscribe to package updates

Last updated Sep 20th, 2013

Download Stats

Last month:2

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.