qr-cli-tool

QR Code Generator & Reader CLI — generate, read, and encode QR codes from the terminal.

Install

pip install qr-cli-tool
# For QR reading support:
pip install qr-cli-tool[read]

Usage

Generate QR codes

# Terminal output (Unicode blocks)
qr generate "https://example.com"

# Save as PNG
qr generate "Hello World" -o hello.png

# Save as SVG
qr generate "data" -o code.svg

# High error correction
qr generate "important" -e H

# Inverted for dark terminals
qr generate "text" --invert

# JSON metadata
qr generate "text" --json

Read QR codes from images

qr read photo.png
qr read screenshot.jpg --json

Requires pyzbar (pip install qr-cli-tool[read]) or zbar CLI (brew install zbar).

Encode structured data

# WiFi network
qr encode "" -t wifi --ssid MyNetwork --password secret123

# Email with subject
qr encode "user@example.com" -t email --subject "Hello"

# Phone number
qr encode "+1234567890" -t phone

# SMS
qr encode "+1234567890" -t sms --body "Hey there"

# Geographic location
qr encode "37.7749,-122.4194" -t geo

# Contact card
qr encode "+1234567890" -t vcard --name "Jane Doe"

List supported types

qr types

Features

• Terminal QR output with Unicode blocks
• PNG and SVG export
• Structured encoding (WiFi, email, phone, SMS, geo, vCard)
• QR reading from images (with pyzbar or zbar)
• Error correction levels (L/M/Q/H)
• JSON output (--json) for automation
• No interactive prompts — fully scriptable

For AI Agents

See SKILL.md for agent-optimized documentation.

License

MIT