qrforge

QR code generator and manager for the terminal.

---

qrforge is a fast, beautiful command-line QR code generator. Instantly create QR codes for URLs, WiFi networks, contacts, email, SMS, and geographic coordinates — rendered directly in your terminal or exported as PNG images with style options.

• Terminal preview — Unicode half-block rendering, no image viewer needed
• WiFi QR codes — Scan to connect, supports WPA/WEP/open networks
• vCard contacts — Share contact info with a single scan
• Email & SMS — Pre-fill recipient, subject, and body
• Geo coordinates — Drop a pin with latitude and longitude
• Batch generation — Process a file of entries, output a directory of PNGs
• History manager — Label, save, and recall any QR code
• Style options — Square, rounded, or circle modules; custom colors; embedded logos
• Error correction — Four levels (L/M/Q/H) including logo-safe H mode

Installation

pip install qrforge

Usage

# Show QR in terminal
qrforge create "https://github.com/shazeus/qrforge"

# Save as PNG with rounded style
qrforge create "https://example.com" -o example.png --style rounded

# WiFi login QR
qrforge wifi --ssid MyNetwork --password s3cr3t

# Contact vCard
qrforge contact --name "Jane Doe" --phone "+1234567890" --email jane@example.com

# Email composer
qrforge email hello@example.com -s "Hey!" -b "Just saying hi"

# SMS pre-fill
qrforge sms +1234567890 -m "On my way"

# Geo pin
qrforge geo 48.8584 2.2945 -q "Eiffel Tower"

# Batch from file
qrforge batch links.txt -d ./output

# History
qrforge create "https://github.com" --label github
qrforge history --show github

Commands

Command	Description
create <data>	Generate QR code from any text or URL
wifi	QR code for WiFi network login
contact	vCard QR code for sharing contacts
email <to>	QR code that opens an email composer
sms <number>	QR code that opens an SMS composer
geo <lat> <lon>	QR code for a geographic location
batch <file>	Bulk generate QR codes from a text file
history	View and manage saved QR codes
styles	List available styles and error levels

Configuration

History is stored in ~/.qrforge/history.json (last 50 entries).

Batch file format (links.txt):

github	https://github.com
docs	https://docs.example.com
plain-url-no-label

Style options: square (default), rounded, circle

Error correction: L (7%), M (15%, default), Q (25%), H (30% — use with --logo)

License

MIT — see LICENSE