Creating QR Codes and Barcodes with Pillow

In today’s digital age, QR codes and barcodes are ubiquitous. They are used in various applications, from inventory management in retail stores to mobile ticketing at events. Python, a versatile programming language, offers multiple libraries to generate these codes. One such library is Pillow, a powerful imaging library that can be used in combination with other barcode and QR code generation libraries to create, manipulate, and save these visual codes. In this blog post, we will explore how to create QR codes and barcodes using Pillow, along with core concepts, typical usage scenarios, common pitfalls, and best practices.

Table of Contents

  1. Core Concepts
  2. Typical Usage Scenarios
  3. Prerequisites
  4. Creating QR Codes with Pillow
  5. Creating Barcodes with Pillow
  6. Common Pitfalls
  7. Best Practices
  8. Conclusion
  9. References

Core Concepts

Pillow

Pillow is a fork of the Python Imaging Library (PIL). It provides a wide range of image processing capabilities, such as opening, manipulating, and saving different image file formats. We can use Pillow to combine generated QR codes and barcodes with other images, add text or logos, and perform other visual enhancements.

QR Codes

QR (Quick Response) codes are two - dimensional barcodes that can store a large amount of data, including URLs, text, contact information, etc. They are designed to be scanned quickly by a mobile device’s camera.

Barcodes

Barcodes are one - dimensional visual representations of data. They are commonly used in retail, logistics, and inventory management to store product information, such as product numbers and prices.

Typical Usage Scenarios

  • Retail: Barcodes are used on product labels for pricing and inventory management. QR codes can be used for marketing purposes, such as providing links to product reviews or additional product information.
  • Event Management: QR codes can be used for ticketing, allowing attendees to scan their tickets on entry.
  • Logistics: Barcodes are used to track packages during shipping, and QR codes can be used to provide more detailed tracking information.

Prerequisites

To follow along with the code examples in this post, you need to have Python installed on your system. You also need to install the following libraries:

  • Pillow: You can install it using pip install pillow.
  • qrcode: For generating QR codes. Install it using pip install qrcode.
  • python-barcode: For generating barcodes. Install it using pip install python-barcode.

Creating QR Codes with Pillow

The following is a Python code example to create a QR code and save it using Pillow:

import qrcode
from PIL import Image

# Data to be encoded in the QR code
data = "https://www.example.com"

# Generate the QR code
qr = qrcode.QRCode(
    version=1,
    error_correction=qrcode.constants.ERROR_CORRECT_L,
    box_size=10,
    border=4,
)
qr.add_data(data)
qr.make(fit=True)

# Create an image from the QR code
qr_img = qr.make_image(fill_color="black", back_color="white")

# Save the image using Pillow
qr_img.save("qr_code.png")

print("QR code saved as qr_code.png")

Explanation:

  1. First, we import the qrcode library to generate the QR code and the Image module from Pillow to save the image.
  2. We define the data to be encoded in the QR code.
  3. We create a QRCode object with specific parameters, such as version, error correction level, box size, and border.
  4. We add the data to the QR code and make it fit the parameters.
  5. We create an image from the QR code with specified fill and background colors.
  6. Finally, we save the image using the save method.

Creating Barcodes with Pillow

The following is a Python code example to create a barcode and save it using Pillow:

import barcode
from barcode.writer import ImageWriter
from PIL import Image

# Data to be encoded in the barcode
data = "1234567890"

# Choose the barcode format (EAN13 in this case)
barcode_format = barcode.get_barcode_class('ean13')

# Create the barcode object
barcode_obj = barcode_format(data, writer=ImageWriter())

# Save the barcode as an image
filename = barcode_obj.save("barcode")

# Open the image using Pillow
barcode_img = Image.open(filename)

# You can perform further operations on the image if needed
barcode_img.show()

print("Barcode saved as barcode.png")

Explanation:

  1. We import the barcode library and the ImageWriter class to generate the barcode as an image. We also import the Image module from Pillow.
  2. We define the data to be encoded in the barcode.
  3. We choose the barcode format (EAN13 in this example).
  4. We create a barcode object with the data and the ImageWriter.
  5. We save the barcode as an image and get the filename.
  6. We open the image using Pillow and can perform further operations if needed.

Common Pitfalls

  • Data Limitations: QR codes and barcodes have limitations on the amount of data they can store. Make sure your data fits within the capacity of the chosen code format.
  • Error Correction: For QR codes, choosing the wrong error correction level can lead to issues with scanning. A higher error correction level allows for more damage to the code but reduces the amount of data that can be stored.
  • Image Quality: Low - quality images of QR codes and barcodes may not scan correctly. Make sure to use appropriate box sizes and resolutions.

Best Practices

  • Test Scanning: Always test the generated QR codes and barcodes using a real - world scanner to ensure they can be read correctly.
  • Data Validation: Validate the data before encoding it to ensure it meets the requirements of the chosen code format.
  • Image Optimization: Use appropriate image compression and resolution settings to balance file size and image quality.

Conclusion

In this blog post, we have explored how to create QR codes and barcodes using Pillow. We have covered the core concepts, typical usage scenarios, provided code examples, discussed common pitfalls, and shared best practices. With this knowledge, you can now generate high - quality QR codes and barcodes for your projects and apply them effectively in real - world situations.

References