tomevault-io QR Code Generator
Generate QR codes from any text or URL data, with support for multiple output formats and visual customization.
Workflow
- Ask where to save the output file:
- Desktop:
~/Desktop/my_qr.svg - Downloads:
~/Downloads/my_qr.svg - Current project directory
- A specific path they provide
- Desktop:
- Run
scripts/generate_qr.pyviauv runwith the user's data and desired options. - Present the result to the user.
Script Usage
The script uses PEP 723 inline metadata to declare its dependency (segno). Run it with uv run and dependencies are resolved and cached automatically — no manual installation required.
uv run ${CLAUDE_PLUGIN_ROOT}/skills/qr-code/scripts/generate_qr.py DATA OUTPUT_PATH [options]
Required Arguments
| Argument | Description |
|---|---|
DATA |
The content to encode (URL, text, etc.) |
OUTPUT_PATH |
Output file path. Extension determines format: .svg, .png, .eps, .pdf, .txt |
Options
| Option | Default | Description |
|---|---|---|
--scale |
10 |
Module scale factor (pixels per module) |
--border |
4 |
Quiet zone border width in modules |
--dark |
#000000 |
Dark module color (hex) |
--light |
#ffffff |
Light module color (hex) |
--error |
M |
Error correction: L=7%, M=15%, Q=25%, H=30% |
--version |
auto | Force a specific QR version (1-40) |
--micro |
off | Create a Micro QR Code (for very short data) |
--transparent |
off | Transparent background (SVG/PNG only) |
Format Guidance
- SVG (
.svg): Recommended default. Scalable vector, ideal for print and web. Smallest file size. - PNG (
.png): Raster image. Requirespillowas an additional dependency. Good for embedding in documents. - EPS (
.eps): Vector format for professional print workflows. - PDF (
.pdf): Vector PDF, good for print-ready documents.
Default to SVG unless the user requests otherwise.
Error Correction Guidance
| Level | Recovery | When to use |
|---|---|---|
| L | 7% | Maximum data density, clean environments |
| M | 15% | Default. Good balance for most uses |
| Q | 25% | QR codes that may be partially obscured |
| H | 30% | QR codes with logos overlaid, harsh environments |
If the user wants to overlay a logo on the QR code, suggest --error H for maximum resilience.
Examples
Generate a basic SVG QR code:
uv run ${CLAUDE_PLUGIN_ROOT}/skills/qr-code/scripts/generate_qr.py "https://example.com/" ~/Desktop/example_qr.svg
Generate a styled PNG with custom colors:
uv run ${CLAUDE_PLUGIN_ROOT}/skills/qr-code/scripts/generate_qr.py "https://example.com/" ~/Downloads/example_qr.png \
--scale 20 --dark "#1a1a2e" --light "#f0f0f0" --error H
Generate a compact Micro QR for short text:
uv run ${CLAUDE_PLUGIN_ROOT}/skills/qr-code/scripts/generate_qr.py "HELLO" ~/Desktop/hello_qr.svg --micro --scale 15
Transparent background SVG:
uv run ${CLAUDE_PLUGIN_ROOT}/skills/qr-code/scripts/generate_qr.py "https://example.com/" ~/Desktop/example_qr.svg --transparent
Converted and distributed by TomeVault — claim your Tome and manage your conversions.