Skip to content
A pure python reader for QR codes
Branch: master
Clone or download
ElNounch and ewino Case typo in test filename
Should fix Travis build
Latest commit a586a8a Jul 30, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
qreader 🐛🚨 Supporting transparent blacks, fixed some warnings Nov 29, 2017
tests Case typo in test filename Aug 1, 2018
.coveralls.yml Updated readme and added coveralls data Sep 19, 2015
.travis.yml 💚 Making sure the dependencies get installed Nov 29, 2017 Update Nov 29, 2017
requirements.txt - Normalized error correction constants to values that make sense. Ad… Jan 30, 2016 💚 Trying to fix the build Nov 29, 2017


A pure python reader for QR codes. Made to be compatible to Python 2.7 to 3.6+.

We use the easy-to-install Pillow package to load the pictures, so lots of picture formats are supported.

Build Status


The package is a work in progress. It can currently decode right-side-up QR codes images generated on a computer (not pictures of printed codes).

Features left to be implemented:

  • QR data error correction (currently being researched and implemented)
  • image recognition to recognize QR codes in camera pictures

Usage  # source can be a file-like object, a PIL image, or a path to a local file

For example:

import qreader
from urllib.request import urlopen

url = ''
data =
print(data)  # prints "Version 2"

Any ideas or issues will be gladly received in the issues panel or by PMing me (ewino)

You can’t perform that action at this time.