BetterQR

BetterQR is a powerful, pure-Python QR code generator with zero external QR Generation dependencies.
It generates beautiful, scannable codes with full control over shapes, colours, gradients,
embedded logos, animated GIFs, Micro QR, and more.

Features

Installation

pip install betterqr --upgrade

Why BetterQR?

Quick Start

CLI

# Basic QR code
betterqr "https://example.com" my_qr.png

# Micro QR (auto-selects smallest version)
betterqr "HELLO" --type micro micro.png

# Styled with gradient
betterqr "Hello" my_qr.png --gradient "#FF6B6B" "#4ECDC4" --gradient-dir radial

# With logo (use ECC H for logos)
betterqr "https://mysite.com" qr.png --logo logo.png --logo-ratio 0.3 --logo-shape rounded -e H

# Animated GIF
betterqr "Animated QR" animated.gif --effect matrix --fps 12

# WiFi
betterqr --wifi MySSID MyPassword output.png

# Contact
betterqr --contact "Jane Doe" --phone "+1-555-1234" --email "jane@example.com" contact.png

Python API

from betterqr import QR, WiFi, VCard, GeoLocation, SMS, Email, Phone

# Basic
QR("https://example.com").save("qr.png")

# Micro QR — all versions
QR("1234",        qr_type="micro", version=1, ecc="M").save("m1.png")  # numeric only
QR("HELLO WORLD", qr_type="micro", version=3, ecc="M").save("m3.png")  # alphanumeric
QR("Hello!",      qr_type="micro", version=4, ecc="L").save("m4.png")  # byte mode

# Styling
(QR("styled")
    .style(shape="circle", fill="#6C3082", back="#F3E8FF")
    .save("styled.png"))

# 3-char hex works too
QR("x").style(fill="#000", back="#FFF").save("mono.png")

# Gradient
QR("gradient").gradient("#FF6B6B", "#4ECDC4", direction="radial").save("grad.png")

# Logo (border=True adds a thin outline around the logo)
(QR("https://mysite.com", ecc="H")
    .logo("logo.png", ratio=0.25, shape="rounded", border=True)
    .save("logo.png"))

# Frame + label
(QR("https://example.com")
    .frame("fancy")
    .label("Scan Me!", position="below")
    .save("framed.png"))

# Animation
QR("Hello", ecc="H", version=4).animate("matrix", frames=30, fps=15).save("anim.gif")

# Data helpers — pass the helper directly or convert to string
QR(WiFi("MyNet", "MyPass", "WPA")).save("wifi.png")
QR(GeoLocation(51.5074, -0.1278)).save("geo.png")
QR(SMS("+15550199", "Hello!")).save("sms.png")
QR(Email("hi@example.com")).save("email.png")
QR(Phone("+18005550199")).save("phone.png")
QR(VCard("Jane Doe", phone="+15550199", email="jane@example.com")).save("vcard.png")

Micro QR Capacities

Documentation

Check out the DOCUMENTATION for an better overview of BetterQR

License

Regsitred under MIT LISCENSE — see LICENSE