x-hw/amazing-qr

Amazing-QR is a Python library for generating QR codes that go beyond the plain black-and-white squares most tools produce. You can create three types of output: a standard QR code, an artistic version that blends a photograph or image into the QR code pattern, and an animated version that uses a GIF file so the QR code itself moves. You install it via pip and can use it either from the command line or by importing it into a Python script. On the command line, you pass in the text or URL you want to encode plus optional flags to control the output size, error correction level, which image to blend in, whether to apply color, and how to adjust the contrast and brightness of the result. From Python code, you call a single function with the same options as keyword arguments. The artistic mode works by overlaying your chosen image onto the QR code grid. By default the result is black and white, but adding the colorized flag keeps the original colors of the image showing through. The animated GIF mode works the same way but accepts an animated GIF as the source image, producing a QR code where each frame of the GIF plays back while remaining scannable. A few practical tips in the README: square images work better than wide rectangles, and if your image has a transparent background, the transparent areas will show through in the QR pattern rather than appearing white, which can make parts of the code harder to read. The library handles only Python 3 and outputs files in PNG, JPG, BMP, or GIF format. The license is GPLv3. The project works on macOS, Linux, and Windows. It was previously published under the name MyQR and is now distributed as the amzqr package on PyPI.