Metadata-Version: 2.4
Name: qrmaster
Version: 1.0.0
Summary: Fast Python QR Code generator & CLI powered by QR Master
Author-email: QR Master Team <support@qrmaster.net>
License-Expression: MIT
Project-URL: Homepage, https://www.qrmaster.net
Project-URL: WiFi QR Generator, https://www.qrmaster.net/tools/wifi-qr-code
Project-URL: vCard QR Generator, https://www.qrmaster.net/tools/vcard-qr-code
Project-URL: WhatsApp QR Generator, https://www.qrmaster.net/tools/whatsapp-qr-code
Project-URL: Source Code, https://github.com/knuthtimo-lab/qrmaster-cli
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: qrcode>=7.4.2
Requires-Dist: pillow>=9.0.0
Dynamic: license-file

# 📱 QR Master Python Package & CLI

> **Fast, zero-setup Python QR Code Generator and Terminal CLI.**  
> Powered by [QR Master](https://www.qrmaster.net) – The Smart QR Code & Analytics Platform.

[![PyPI version](https://img.shields.io/pypi/v/qrmaster.svg?style=flat-square)](https://pypi.org/project/qrmaster/)
[![Python versions](https://img.shields.io/pypi/pyversions/qrmaster.svg?style=flat-square)](https://pypi.org/project/qrmaster/)
[![License](https://img.shields.io/github/license/knuthtimo-lab/qrmaster-cli.svg?style=flat-square)](LICENSE)

---

## ✨ Features

- ⚡ **Zero Configuration CLI**: Generate terminal ASCII QR codes in seconds using `qrmaster "https://www.qrmaster.net"`.
- 🖼️ **PNG & Vector SVG Export**: Save crisp PNG raster files or scalable SVG vector files directly to disk.
- 📡 **WiFi & vCard Generators**: Built-in helper functions for instant WiFi connections and vCard contact cards.
- 🔗 **Powered by [QR Master](https://www.qrmaster.net)**: Need dynamic QR codes with live tracking, custom logo branding, and high-volume vector PDF export? Visit QR Master.

---

## 🚀 Installation

Install via `pip`:

```bash
pip install qrmaster
```

---

## 💻 CLI Usage

```bash
# Print QR code directly in terminal
qrmaster "https://www.qrmaster.net"

# Save as PNG image
qrmaster "https://www.qrmaster.net" -o qrmaster.png

# Save as SVG vector file
qrmaster "https://www.qrmaster.net" -o qrmaster.svg
```

### 📶 WiFi QR Code

```bash
qrmaster --wifi --ssid "MyHomeWiFi" --password "<wifi-password>" -o wifi.png
```

### 👤 vCard Contact QR Code

```bash
qrmaster --vcard --name "Alex Smith" --email "alex@example.com" --phone "+123456789"
```

---

## 🐍 Python SDK API Usage

Use `qrmaster` directly inside your Python applications:

```python
from qrmaster import generate_qr, build_wifi_payload, build_vcard_payload

# Generate terminal QR
generate_qr("https://www.qrmaster.net")

# Save PNG image file
generate_qr("https://www.qrmaster.net", output="qrmaster.png")

# Generate WiFi payload & save vector SVG
wifi_data = build_wifi_payload(ssid="Office-5G", password="<wifi-password>")
generate_qr(wifi_data, output="wifi.svg")
```

---

## 🌐 Need Dynamic QR Codes & Analytics?

Static QR codes are great for local terminal use, but if you need:
- 📊 **Real-time Scan Analytics & Location Tracking**
- 🎨 **Custom Brand Colors, Logos & Styled Frames**
- 🔄 **Dynamic Target URLs (Change destination without re-printing)**
- 🏢 **Bulk Vector PDF Export for Commercial Printing**

Visit [QR Master - Free Smart QR Code Generator](https://www.qrmaster.net).

### 🛠️ Free Micro Tools by QR Master
- [WiFi QR Code Generator](https://www.qrmaster.net/tools/wifi-qr-code)
- [VCard QR Code Generator](https://www.qrmaster.net/tools/vcard-qr-code)
- [WhatsApp QR Code Generator](https://www.qrmaster.net/tools/whatsapp-qr-code)

---

## 📄 License

MIT © [QR Master](https://www.qrmaster.net)
