batch-qr-generator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Batch QR Generator

批量二维码生成器

Generate bulk QR codes from CSV data with UTM tracking, logos, and customizable styling for events, products, and marketing.
从CSV数据批量生成带UTM追踪、logo和可自定义样式的二维码,适用于活动、产品和营销场景。

Purpose

用途

Bulk QR code generation for:
  • Event ticketing and check-in
  • Product inventory tracking
  • Marketing campaign tracking (UTM parameters)
  • Business card contact sharing
  • Bulk URL shortening with QR codes
批量二维码生成适用于:
  • 活动票务与签到
  • 产品库存追踪
  • 营销活动追踪(UTM参数)
  • 名片联系方式分享
  • 带二维码的批量URL缩短

Features

功能特性

  • CSV Input: Generate from spreadsheet data
  • UTM Tracking: Auto-add campaign tracking parameters
  • Custom Styling: Colors, logos, error correction
  • Sequential Naming: Auto-generate filenames
  • Metadata Export: CSV with QR data and filenames
  • Format Options: PNG, SVG output
  • CSV输入:从电子表格数据生成
  • UTM追踪:自动添加活动追踪参数
  • 自定义样式:颜色、logo、纠错级别
  • 序列命名:自动生成文件名
  • 元数据导出:包含二维码数据和文件名的CSV
  • 格式选项:PNG、SVG输出

Quick Start

快速开始

python
from batch_qr_generator import BatchQRGenerator
python
from batch_qr_generator import BatchQRGenerator

Generate from CSV

Generate from CSV

generator = BatchQRGenerator() generator.load_csv('products.csv', url_column='product_url') generator.add_utm_params(source='catalog', medium='qr', campaign='2024Q1') generator.generate_batch(output_dir='qr_codes/')
undefined
generator = BatchQRGenerator() generator.load_csv('products.csv', url_column='product_url') generator.add_utm_params(source='catalog', medium='qr', campaign='2024Q1') generator.generate_batch(output_dir='qr_codes/')
undefined

CLI Usage

CLI 使用方式

bash
undefined
bash
undefined

Generate QR codes from CSV

Generate QR codes from CSV

python batch_qr_generator.py --csv products.csv --url-column url --output-dir qr_codes/
python batch_qr_generator.py --csv products.csv --url-column url --output-dir qr_codes/

Add UTM tracking

Add UTM tracking

python batch_qr_generator.py --csv products.csv --url-column url --utm-source catalog --utm-campaign 2024Q1 --output-dir qr_codes/
python batch_qr_generator.py --csv products.csv --url-column url --utm-source catalog --utm-campaign 2024Q1 --output-dir qr_codes/

Add logo

Add logo

python batch_qr_generator.py --csv urls.csv --url-column link --logo logo.png --output-dir branded_qr/
undefined
python batch_qr_generator.py --csv urls.csv --url-column link --logo logo.png --output-dir branded_qr/
undefined