semvec/pypi-packages huggingface dataset:
qr-cli-tool 0.1.0
QR Code Generator & Reader CLI — generate, read, and encode QR codes from the terminal
License: MIT
Requires Python: >=3.9
Keywords: qr, qrcode, cli, generator, reader, terminal

# 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