Skip to main content

batchqr

PyPI version Python versions License: MIT

Generate QR codes in large batches with parallel processing.

Features

  • Batch generation — process thousands of QR codes in parallel
  • Multiple input formats — CSV, JSON, Excel, or Python lists
  • Multiple output formats — PNG, SVG, PDF, EPS
  • Flexible export — individual files, ZIP archives, or PDF label sheets
  • Styling — custom colors, logo overlays, preset themes
  • CLI & API — use from the command line or as a Python library
  • Fault-tolerant — per-item error handling, failed items don't kill the batch

Installation

pip install batchqr

With optional dependencies:

pip install batchqr[pdf]      # PDF sheet export
pip install batchqr[excel]    # Excel input support
pip install batchqr[all]      # Everything

Quick Start

Python API

import batchqr

# Single QR code
batchqr.make("https://example.com").save("qr.png")

# Batch generation
results = batchqr.batch([
    "https://example.com/1",
    "https://example.com/2",
    "https://example.com/3",
]).save_all("./qrcodes/")

From CSV

import batchqr

batchqr.batch.from_csv("data.csv").save_zip("qrcodes.zip")

CLI

# Generate from inline data
batchqr make "https://example.com" -o qr.png

# Batch from CSV
batchqr batch data.csv --output ./qrcodes/

# Legacy CLI still works
qrbatch generate --input data.csv --output ./qrcodes/ --format png

Configuration

from batchqr import QRConfig

config = QRConfig(
    error_correction="H",   # L, M, Q, H
    box_size=10,
    border=4,
    fg_color="#000000",
    bg_color="#ffffff",
    image_format="png",
)

Styling

import batchqr

# Use a preset theme
qr = batchqr.make("https://example.com").theme("corporate-blue").save("styled.png")

# Or customize directly
qr = batchqr.make("https://example.com").color("#1a1a2e", "#ffffff").style("rounded").save("custom.png")

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT LICENSE

Metadata

Release files for batchqr 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for batchqr 1.0.1
File Size Uploaded Provenance
batchqr-1.0.1.tar.gz 51.0 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for batchqr 1.0.1
File Interpreter ABI Platform
batchqr-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 95.6 kB

Release files / batchqr-1.0.1.tar.gz

Download URL batchqr-1.0.1.tar.gz
Size 51.0 kB
Tags Source
SHA-256 checksum
How to use checksums
c9e6b2e18e2be57cc833d39375c51097794b96a3552e3f5e4b31d5a5eed44790
BLAKE2b-256 checksum
How to use checksums
33c56bc2371ca58eaed5798ff183f69986729fcd5c83fce3664471e5c81a8933
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 5, 2026.

Transparency log

Release files / batchqr-1.0.1-py3-none-any.whl

Download URL batchqr-1.0.1-py3-none-any.whl
Size 44.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
90118fc901ef875381d6c0873557a34f1c3c8e1c3960cd69cae4131d1dfe3dc4
BLAKE2b-256 checksum
How to use checksums
3fa61073be822bb29b5abf75002e0e8e1e0a13007fa8605c6ff6dc4bd95f319b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 5, 2026.

Transparency log

Security for batchqr 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for batchqr-1.0.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 5, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page