Skip to content

olorin/prettyqr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

prettyqr

Create QR codes merged with images.

This package creates QR codes based on image files; the QR code is superimposed on the image, optionally with reduced transparency, such that the readability of the QR code can be maximized (they aren't normally intended to be read from noisy backgrounds such as other images).

Installation

pip install prettyqr

You will need Python and pip.

Example usage

Take a background image:

Original image

And a URL or some other text:

foo.com

Combine them:

prettyqr --qr-opacity 150 --outfile img/dna-qr.png foo.com img/dna-orig.png

QR code image

Command-line options

usage: prettyqr [-h] [--border BORDER] [--out-file OUT_FILE]
                [--qr-opacity QR_OPACITY] [--qr-red QR_RED]
                [--qr-green QR_GREEN] [--qr-blue QR_BLUE]
                DATA IMAGE-FILE

Make pretty QR codes.

positional arguments:
  DATA                  Data to encode (e.g., "http://example.com").
  IMAGE-FILE            Image file to composite (e.g., "lena.jpg").

optional arguments:
  -h, --help            show this help message and exit
  --border BORDER       Size of border (in multiples of QR module size).
                        Defaults to 4. Can be zero if the QR code is intended
                        for printing or use on a light background.
  --out-file OUT_FILE   Path to write composite image file to. Extension will
                        determine the output format. Defaults to
                        "prettyqr.png".
  --qr-opacity QR_OPACITY
                        Opacity of the QR code modules, between 0 (invisible)
                        and 255 (opaque). Default is 200.
  --qr-red QR_RED       Red element of the QR module color, between 0 and 255.
                        Default is 0.
  --qr-green QR_GREEN   Green element of the QR module color, between 0 and
                        255. Default is 0.
  --qr-blue QR_BLUE     Blue element of the QR module color, between 0 and
                        255. Default is 0.

Limitations

prettyqr is a fairly raw proof-of-concept, and currently has an assortment of limitations:

  • Only supports square images.
  • Only supports square QR modules.
  • Doesn't support complex color changes in the source image.

It will work best with sources where the focus of the image is not central, and doesn't handle black backgrounds very well.

All of these issues are fairly tractable; patches are welcome.

About

Generate QR codes melded with images.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages