Metadata-Version: 2.4
Name: qr-cli-tool
Version: 0.1.0
Summary: QR Code Generator & Reader CLI — generate, read, and encode QR codes from the terminal
Author-email: Marcus <marcus.builds.things@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/qr-cli
Project-URL: Repository, https://github.com/marcusbuildsthings-droid/qr-cli
Project-URL: Issues, https://github.com/marcusbuildsthings-droid/qr-cli/issues
Keywords: qr,qrcode,cli,generator,reader,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: qrcode>=7.0
Requires-Dist: pillow>=9.0
Provides-Extra: read
Requires-Dist: pyzbar>=0.1.9; extra == "read"
Dynamic: license-file

# qr-cli-tool

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

## Install

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

## Usage

### Generate QR codes

```bash
# 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

```bash
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

```bash
# 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

```bash
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](SKILL.md) for agent-optimized documentation.

## License

MIT
