{ "schemaVersion": "1.0", "item": { "slug": "qr-code-generator", "name": "Qr Code Generator", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/anisafifi/qr-code-generator", "canonicalUrl": "https://clawhub.ai/anisafifi/qr-code-generator", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/qr-code-generator", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=qr-code-generator", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "references/readme.md", "scripts/qr.py", "scripts/requirements.txt" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/qr-code-generator" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/qr-code-generator", "agentPageUrl": "https://openagent3.xyz/skills/qr-code-generator/agent", "manifestUrl": "https://openagent3.xyz/skills/qr-code-generator/agent.json", "briefUrl": "https://openagent3.xyz/skills/qr-code-generator/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "QR Code Generator", "body": "Generate customizable QR codes for URLs, text, WiFi credentials, contact cards, and more. Supports batch generation, custom styling, logo embedding, and multiple export formats.\n\n⚠️ Prerequisite: Install OpenClawCLI (Windows, MacOS)\n\nInstallation:\n\n# Standard installation\npip install qrcode[pil] segno\n\n# If you encounter permission errors, use a virtual environment\npython -m venv venv\nsource venv/bin/activate # On Windows: venv\\Scripts\\activate\npip install qrcode[pil] segno\n\nNever use --break-system-packages as it can damage your system's Python installation." }, { "title": "Quick Reference", "body": "TaskCommandBasic URL QR codepython scripts/qr.py \"https://example.com\"Text QR codepython scripts/qr.py --type text \"Hello World\"WiFi QR codepython scripts/qr.py --type wifi --ssid \"MyNetwork\" --password \"secret\"vCard contactpython scripts/qr.py --type vcard --name \"John Doe\" --phone \"+1234567890\"Custom colorspython scripts/qr.py \"URL\" --fg-color blue --bg-color whiteWith logopython scripts/qr.py \"URL\" --logo logo.pngSVG formatpython scripts/qr.py \"URL\" --format svgBatch generationpython scripts/qr.py --batch urls.txt --output-dir qrcodes/" }, { "title": "1. Multiple Data Types", "body": "Generate QR codes for various data types with automatic formatting.\n\nSupported Types:\n\nURL - Websites and web links\nText - Plain text messages\nWiFi - WiFi network credentials\nvCard - Contact information (VCF format)\nEmail - Email addresses with optional subject/body\nPhone - Phone numbers (tel: links)\nSMS - SMS messages with recipient and text\nGeo - Geographic coordinates\nEvent - Calendar events (iCal format)\nCustom - Any custom data" }, { "title": "2. Customization Options", "body": "Personalize QR code appearance:\n\nForeground and background colors\nCustom error correction levels\nBorder size adjustment\nModule size control\nLogo/image embedding" }, { "title": "3. Multiple Export Formats", "body": "Export in various formats for different use cases:\n\nPNG - Raster images (default)\nSVG - Vector graphics (scalable)\nPDF - Print-ready documents\nEPS - Vector format for design tools\nTerminal - ASCII art for terminal display" }, { "title": "4. Batch Processing", "body": "Generate multiple QR codes from:\n\nText files (one entry per line)\nCSV files (with metadata)\nJSON files (with configuration)" }, { "title": "URL QR Codes", "body": "Generate QR codes for websites and links.\n\n# Simple URL\npython scripts/qr.py \"https://example.com\"\n\n# With custom filename\npython scripts/qr.py \"https://github.com\" --output github_qr.png\n\n# High error correction for printed codes\npython scripts/qr.py \"https://mysite.com\" --error-correction H --output site_qr.png\n\nOutput:\n\nQR code generated: qrcode.png\nSize: 290x290 pixels\nError correction: M (Medium)\nData: https://example.com" }, { "title": "Text QR Codes", "body": "Encode plain text messages.\n\n# Simple text\npython scripts/qr.py --type text \"Hello, World!\"\n\n# Multi-line text\npython scripts/qr.py --type text \"Line 1\\nLine 2\\nLine 3\" --output message.png\n\n# Large text (automatic size adjustment)\npython scripts/qr.py --type text \"$(cat message.txt)\" --output text_qr.png" }, { "title": "WiFi QR Codes", "body": "Create scannable WiFi credentials.\n\n# WPA/WPA2 network\npython scripts/qr.py --type wifi --ssid \"MyNetwork\" --password \"SecurePassword123\"\n\n# WPA2 network (explicit)\npython scripts/qr.py --type wifi --ssid \"HomeWiFi\" --password \"pass123\" --security WPA\n\n# Hidden network\npython scripts/qr.py --type wifi --ssid \"SecretNet\" --password \"secret\" --hidden\n\n# Open network (no password)\npython scripts/qr.py --type wifi --ssid \"GuestNetwork\" --security nopass\n\nSecurity types: WPA, WEP, nopass\n\nOutput QR contains:\n\nWIFI:T:WPA;S:MyNetwork;P:SecurePassword123;H:false;;" }, { "title": "Contact Cards (vCard)", "body": "Generate vCard QR codes for easy contact sharing.\n\n# Basic contact\npython scripts/qr.py --type vcard --name \"John Doe\" --phone \"+1234567890\"\n\n# Full contact details\npython scripts/qr.py --type vcard \\\n --name \"Jane Smith\" \\\n --phone \"+1234567890\" \\\n --email \"jane@example.com\" \\\n --organization \"Tech Corp\" \\\n --title \"Senior Developer\" \\\n --url \"https://janesmith.com\" \\\n --address \"123 Main St, City, State, 12345\" \\\n --output jane_contact.png\n\n# Multiple phone numbers\npython scripts/qr.py --type vcard \\\n --name \"Bob Johnson\" \\\n --phone \"+1234567890\" \\\n --phone-home \"+0987654321\" \\\n --email \"bob@email.com\"\n\nGenerated vCard format:\n\nBEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nTEL:+1234567890\nEND:VCARD" }, { "title": "Email QR Codes", "body": "Create mailto: links with optional subject and body.\n\n# Simple email\npython scripts/qr.py --type email --email \"contact@example.com\"\n\n# With subject\npython scripts/qr.py --type email --email \"support@company.com\" --subject \"Support Request\"\n\n# With subject and body\npython scripts/qr.py --type email \\\n --email \"info@example.com\" \\\n --subject \"Inquiry\" \\\n --body \"I would like more information about...\"\n\nOutput QR contains:\n\nmailto:contact@example.com?subject=Support%20Request&body=Message%20text" }, { "title": "Phone Number QR Codes", "body": "Generate clickable phone links.\n\n# Simple phone number\npython scripts/qr.py --type phone --phone \"+1234567890\"\n\n# International format\npython scripts/qr.py --type phone --phone \"+44 20 7946 0958\"\n\nOutput QR contains:\n\ntel:+1234567890" }, { "title": "SMS QR Codes", "body": "Create pre-filled SMS messages.\n\n# SMS with recipient only\npython scripts/qr.py --type sms --phone \"+1234567890\"\n\n# SMS with message\npython scripts/qr.py --type sms --phone \"+1234567890\" --message \"Hello from QR code!\"\n\nOutput QR contains:\n\nsms:+1234567890?body=Hello%20from%20QR%20code!" }, { "title": "Geographic Location QR Codes", "body": "Encode GPS coordinates.\n\n# Coordinates only\npython scripts/qr.py --type geo --latitude 37.7749 --longitude -122.4194\n\n# With altitude\npython scripts/qr.py --type geo --latitude 40.7128 --longitude -74.0060 --altitude 10\n\n# Named location\npython scripts/qr.py --type geo --latitude 51.5074 --longitude -0.1278 --location-name \"London\"\n\nOutput QR contains:\n\ngeo:37.7749,-122.4194" }, { "title": "Calendar Event QR Codes", "body": "Generate iCalendar event QR codes.\n\n# Basic event\npython scripts/qr.py --type event \\\n --event-title \"Team Meeting\" \\\n --event-start \"2024-03-15T14:00:00\" \\\n --event-end \"2024-03-15T15:00:00\"\n\n# Full event details\npython scripts/qr.py --type event \\\n --event-title \"Conference 2024\" \\\n --event-start \"2024-06-01T09:00:00\" \\\n --event-end \"2024-06-01T17:00:00\" \\\n --event-location \"Convention Center, NYC\" \\\n --event-description \"Annual tech conference\" \\\n --output conference_qr.png" }, { "title": "Colors", "body": "Customize foreground and background colors.\n\n# Named colors\npython scripts/qr.py \"https://example.com\" --fg-color blue --bg-color white\n\n# Hex colors\npython scripts/qr.py \"https://example.com\" --fg-color \"#FF0000\" --bg-color \"#FFFFFF\"\n\n# RGB colors\npython scripts/qr.py \"https://example.com\" --fg-color \"rgb(0,100,200)\" --bg-color \"rgb(255,255,255)\"\n\n# Transparent background\npython scripts/qr.py \"https://example.com\" --bg-color transparent --format png\n\nCommon color names: black, white, red, blue, green, yellow, orange, purple, pink, brown, gray" }, { "title": "Error Correction", "body": "Set error correction level (higher = more damage resistance).\n\n--error-correction \n\nLevels:\n\nL - Low (~7% recovery) - Use for digital display\nM - Medium (~15% recovery) - Default, good balance\nQ - Quartile (~25% recovery) - Use when adding logos\nH - High (~30% recovery) - Best for print, damaged surfaces\n\n# Low (smallest QR code)\npython scripts/qr.py \"https://example.com\" --error-correction L\n\n# High (best for print with logo)\npython scripts/qr.py \"https://example.com\" --error-correction H --logo company.png" }, { "title": "Size and Border", "body": "Control QR code size and border width.\n\n# Custom module size (box size in pixels)\npython scripts/qr.py \"URL\" --box-size 20\n\n# Custom border (modules)\npython scripts/qr.py \"URL\" --border 2\n\n# Large QR code\npython scripts/qr.py \"URL\" --box-size 30 --border 4 --output large_qr.png\n\n# Minimal QR code (no border)\npython scripts/qr.py \"URL\" --border 0 --output minimal_qr.png\n\nDefaults:\n\nBox size: 10 pixels\nBorder: 4 modules (recommended minimum)" }, { "title": "Logo Embedding", "body": "Add logos or images to QR codes.\n\n# Add logo (center)\npython scripts/qr.py \"https://company.com\" --logo company_logo.png\n\n# Custom logo size (percentage of QR code)\npython scripts/qr.py \"URL\" --logo logo.png --logo-size 20\n\n# High error correction recommended with logos\npython scripts/qr.py \"URL\" --logo logo.png --error-correction H\n\nLogo tips:\n\nUse square or circular logos\nKeep logo size ≤ 30% of QR code\nUse high error correction (Q or H)\nTest scanning after adding logo" }, { "title": "PNG (Default)", "body": "Raster image format, good for digital use.\n\npython scripts/qr.py \"https://example.com\" --format png --output qr.png\n\nBest for: Web, digital displays, simple sharing" }, { "title": "SVG (Vector)", "body": "Scalable vector graphics, perfect for any size.\n\npython scripts/qr.py \"https://example.com\" --format svg --output qr.svg\n\nBest for: Print, design work, scaling to any size" }, { "title": "PDF", "body": "Print-ready PDF documents.\n\npython scripts/qr.py \"https://example.com\" --format pdf --output qr.pdf\n\nBest for: Printing, documents, archival" }, { "title": "EPS", "body": "Encapsulated PostScript for professional design tools.\n\npython scripts/qr.py \"https://example.com\" --format eps --output qr.eps\n\nBest for: Professional design software (Adobe Illustrator, etc.)" }, { "title": "Terminal", "body": "Display QR code as ASCII art in terminal.\n\npython scripts/qr.py \"https://example.com\" --format terminal\n\nOutput:\n\n█████████████████████████████\n█████████████████████████████\n████ ▄▄▄▄▄ █▀█ █▄▄▄▄▄ ████\n████ █ █ █▀▀▀█ █ █ ████\n████ █▄▄▄█ █▀ ▀ █▄▄▄█ ████\n...\n\nBest for: Quick terminal display, debugging" }, { "title": "From Text File", "body": "Generate QR codes from a list of URLs or text.\n\n# Create input file\ncat > urls.txt << EOF\nhttps://example.com\nhttps://github.com\nhttps://google.com\nEOF\n\n# Generate batch\npython scripts/qr.py --batch urls.txt --output-dir qrcodes/\n\nOutput:\n\nqrcodes/\n ├── qr_001.png\n ├── qr_002.png\n └── qr_003.png" }, { "title": "From CSV File", "body": "Generate with metadata (filenames, options).\n\n# Create CSV\ncat > contacts.csv << EOF\nname,phone,email,filename\nJohn Doe,+1234567890,john@example.com,john_qr.png\nJane Smith,+0987654321,jane@example.com,jane_qr.png\nEOF\n\n# Generate batch\npython scripts/qr.py --batch contacts.csv --type vcard --output-dir contacts/" }, { "title": "From JSON File", "body": "Generate with full customization per QR code.\n\n# Create JSON config\ncat > qr_config.json << EOF\n[\n {\n \"data\": \"https://example.com\",\n \"output\": \"example_qr.png\",\n \"fg_color\": \"blue\",\n \"bg_color\": \"white\"\n },\n {\n \"type\": \"wifi\",\n \"ssid\": \"MyNetwork\",\n \"password\": \"secret\",\n \"output\": \"wifi_qr.png\"\n }\n]\nEOF\n\n# Generate batch\npython scripts/qr.py --batch qr_config.json --output-dir custom/" }, { "title": "Event Check-In System", "body": "Generate QR codes for event tickets.\n\n# Create ticket QR codes with unique IDs\npython scripts/qr.py --type text \"TICKET-001-VIP\" --output tickets/ticket_001.png\npython scripts/qr.py --type text \"TICKET-002-GENERAL\" --output tickets/ticket_002.png\n\n# Or batch from CSV\ncat > tickets.csv << EOF\nticket_id,type,name\nTICKET-001,VIP,John Doe\nTICKET-002,GENERAL,Jane Smith\nEOF\n\npython scripts/qr.py --batch tickets.csv --template \"TICKET-{ticket_id}-{type}\" --output-dir tickets/" }, { "title": "Restaurant Menu", "body": "Create QR code for digital menu.\n\n# Menu URL\npython scripts/qr.py \"https://restaurant.com/menu\" \\\n --output menu_qr.png \\\n --box-size 15 \\\n --error-correction H\n\n# Print version (PDF)\npython scripts/qr.py \"https://restaurant.com/menu\" \\\n --format pdf \\\n --output menu_qr.pdf \\\n --box-size 20" }, { "title": "WiFi Guest Access", "body": "Generate WiFi QR code for guests.\n\n# Print-friendly version\npython scripts/qr.py --type wifi \\\n --ssid \"Guest_Network\" \\\n --password \"GuestPass123\" \\\n --format pdf \\\n --output wifi_guest.pdf \\\n --box-size 15 \\\n --error-correction H\n\n# Poster with logo\npython scripts/qr.py --type wifi \\\n --ssid \"Guest_Network\" \\\n --password \"GuestPass123\" \\\n --logo company_logo.png \\\n --output wifi_poster.png \\\n --box-size 20" }, { "title": "Contact Card Distribution", "body": "Create scannable business cards.\n\n# Generate vCard\npython scripts/qr.py --type vcard \\\n --name \"John Doe\" \\\n --phone \"+1234567890\" \\\n --email \"john@company.com\" \\\n --organization \"Tech Corp\" \\\n --title \"CEO\" \\\n --url \"https://company.com\" \\\n --format svg \\\n --output business_card.svg\n\n# Print version\npython scripts/qr.py --type vcard \\\n --name \"John Doe\" \\\n --phone \"+1234567890\" \\\n --email \"john@company.com\" \\\n --format pdf \\\n --output business_card.pdf \\\n --box-size 12" }, { "title": "Product Packaging", "body": "QR codes for product information.\n\n# Product info URL\npython scripts/qr.py \"https://product.com/info/SKU12345\" \\\n --output product_qr.svg \\\n --format svg \\\n --fg-color \"#000000\" \\\n --bg-color transparent\n\n# With error correction for damaged packaging\npython scripts/qr.py \"https://product.com/info/SKU12345\" \\\n --error-correction H \\\n --output product_qr_robust.png" }, { "title": "Social Media Links", "body": "QR codes for social profiles.\n\n# Instagram\npython scripts/qr.py \"https://instagram.com/username\" --output instagram_qr.png\n\n# LinkedIn\npython scripts/qr.py \"https://linkedin.com/in/username\" --output linkedin_qr.png\n\n# Multiple platforms (batch)\ncat > social.txt << EOF\nhttps://twitter.com/username\nhttps://instagram.com/username\nhttps://linkedin.com/in/username\nhttps://github.com/username\nEOF\n\npython scripts/qr.py --batch social.txt --output-dir social_qr/" }, { "title": "Payment Links", "body": "QR codes for payment services.\n\n# PayPal\npython scripts/qr.py \"https://paypal.me/username\" --output paypal_qr.png\n\n# Venmo\npython scripts/qr.py \"venmo://username\" --output venmo_qr.png\n\n# Cash App\npython scripts/qr.py \"https://cash.app/$username\" --output cashapp_qr.png" }, { "title": "Size and Scanning", "body": "Minimum size: 2cm × 2cm for reliable scanning\nViewing distance: QR size should be 10% of scanning distance\nBorder: Keep at least 4 modules border (quiet zone)\nTesting: Always test scan before printing" }, { "title": "Error Correction", "body": "Digital display: Use L or M\nPrint without logo: Use M\nPrint with logo: Use H\nOutdoor/damaged: Use H" }, { "title": "Colors", "body": "High contrast: Dark foreground, light background\nAvoid: Light colors on light, dark on dark\nPrint: Use pure black/white for best results\nBranding: Test custom colors before mass production" }, { "title": "Logo Integration", "body": "Size: Keep logo ≤ 25-30% of QR code\nError correction: Use Q or H level\nPosition: Center placement works best\nTesting: Verify scanning with logo" }, { "title": "File Formats", "body": "Digital: PNG for web, screens\nPrint: PDF or SVG for scalability\nDesign: SVG or EPS for editing\nArchive: Keep source data and SVG version" }, { "title": "Installation Issues", "body": "\"Missing required dependency\"\n\n# Install dependencies\npip install qrcode[pil] segno\n\n# Or use virtual environment\npython -m venv venv\nsource venv/bin/activate\npip install qrcode[pil] segno\n\n\"PIL/Pillow not found\"\n\npip install Pillow" }, { "title": "Generation Issues", "body": "\"QR code too complex\"\n\nReduce data size\nUse higher version (auto-adjusts)\nSplit into multiple QR codes\n\n\"Cannot scan QR code\"\n\nIncrease error correction\nEnsure sufficient contrast\nCheck minimum size\nRemove or reduce logo size\nTest in good lighting\n\n\"Logo obscures data\"\n\nReduce logo size (--logo-size)\nIncrease error correction to H\nUse simpler logo design" }, { "title": "File Issues", "body": "\"Cannot save file\"\n\nCheck output directory exists\nVerify write permissions\nCheck disk space\n\n\"Invalid color format\"\n\nUse named colors: red, blue, green\nUse hex: #RRGGBB\nUse rgb: rgb(R,G,B)" }, { "title": "Command Reference", "body": "python scripts/qr.py [DATA] [OPTIONS]\n\nDATA:\n Text string, URL, or data to encode (required unless using --batch)\n\nGENERAL OPTIONS:\n --type Data type (url|text|wifi|vcard|email|phone|sms|geo|event)\n -o, --output Output filename (default: qrcode.png)\n -f, --format Format (png|svg|pdf|eps|terminal)\n \nCUSTOMIZATION:\n --fg-color Foreground color (default: black)\n --bg-color Background color (default: white)\n --error-correction Error correction (L|M|Q|H, default: M)\n --box-size Module size in pixels (default: 10)\n --border Border size in modules (default: 4)\n --logo Logo image path\n --logo-size Logo size percentage (default: 20)\n\nWIFI OPTIONS:\n --ssid Network SSID\n --password Network password\n --security Security type (WPA|WEP|nopass)\n --hidden Hidden network flag\n\nVCARD OPTIONS:\n --name Full name\n --phone Phone number\n --phone-home Home phone\n --phone-work Work phone\n --email Email address\n --organization Company/organization\n --title Job title\n --url Website URL\n --address Full address\n\nEMAIL OPTIONS:\n --email Email address\n --subject Email subject\n --body Email body\n\nPHONE/SMS OPTIONS:\n --phone Phone number\n --message SMS message text\n\nGEO OPTIONS:\n --latitude Latitude coordinate\n --longitude Longitude coordinate\n --altitude Altitude (optional)\n --location-name Location name (optional)\n\nEVENT OPTIONS:\n --event-title Event title\n --event-start Start datetime (ISO format)\n --event-end End datetime (ISO format)\n --event-location Event location\n --event-description Event description\n\nBATCH OPTIONS:\n --batch Input file (txt|csv|json)\n --output-dir Output directory for batch\n --template Filename template for batch\n\nHELP:\n --help Show all options" }, { "title": "Quick QR Codes", "body": "# URL\npython scripts/qr.py \"https://example.com\"\n\n# Text\npython scripts/qr.py --type text \"Hello World\"\n\n# Phone\npython scripts/qr.py --type phone --phone \"+1234567890\"" }, { "title": "Professional QR Codes", "body": "# With logo and custom colors\npython scripts/qr.py \"https://company.com\" \\\n --logo logo.png \\\n --fg-color \"#003366\" \\\n --bg-color \"#FFFFFF\" \\\n --error-correction H \\\n --output company_qr.png\n\n# Print-ready\npython scripts/qr.py \"https://company.com\" \\\n --format pdf \\\n --box-size 15 \\\n --error-correction H \\\n --output printable_qr.pdf" }, { "title": "Functional QR Codes", "body": "# WiFi access\npython scripts/qr.py --type wifi --ssid \"Network\" --password \"pass123\"\n\n# Contact card\npython scripts/qr.py --type vcard --name \"John Doe\" --phone \"+1234567890\" --email \"john@example.com\"\n\n# Calendar event\npython scripts/qr.py --type event --event-title \"Meeting\" --event-start \"2024-03-15T14:00:00\" --event-end \"2024-03-15T15:00:00\"" }, { "title": "Bulk Generation", "body": "# From URL list\npython scripts/qr.py --batch urls.txt --output-dir qrcodes/\n\n# From CSV with metadata\npython scripts/qr.py --batch data.csv --output-dir output/\n\n# Custom configuration per code\npython scripts/qr.py --batch config.json --output-dir custom/" }, { "title": "Support", "body": "For issues or questions:\n\nCheck this documentation\nRun python scripts/qr.py --help\nVerify dependencies are installed\nTest with simple QR code first\n\nResources:\n\nOpenClawCLI: https://clawhub.ai/\nqrcode library: https://pypi.org/project/qrcode/\nsegno library: https://pypi.org/project/segno/\nQR code specification: ISO/IEC 18004" } ], "body": "QR Code Generator\n\nGenerate customizable QR codes for URLs, text, WiFi credentials, contact cards, and more. Supports batch generation, custom styling, logo embedding, and multiple export formats.\n\n⚠️ Prerequisite: Install OpenClawCLI (Windows, MacOS)\n\nInstallation:\n\n# Standard installation\npip install qrcode[pil] segno\n\n# If you encounter permission errors, use a virtual environment\npython -m venv venv\nsource venv/bin/activate # On Windows: venv\\Scripts\\activate\npip install qrcode[pil] segno\n\n\nNever use --break-system-packages as it can damage your system's Python installation.\n\nQuick Reference\nTask\tCommand\nBasic URL QR code\tpython scripts/qr.py \"https://example.com\"\nText QR code\tpython scripts/qr.py --type text \"Hello World\"\nWiFi QR code\tpython scripts/qr.py --type wifi --ssid \"MyNetwork\" --password \"secret\"\nvCard contact\tpython scripts/qr.py --type vcard --name \"John Doe\" --phone \"+1234567890\"\nCustom colors\tpython scripts/qr.py \"URL\" --fg-color blue --bg-color white\nWith logo\tpython scripts/qr.py \"URL\" --logo logo.png\nSVG format\tpython scripts/qr.py \"URL\" --format svg\nBatch generation\tpython scripts/qr.py --batch urls.txt --output-dir qrcodes/\nCore Features\n1. Multiple Data Types\n\nGenerate QR codes for various data types with automatic formatting.\n\nSupported Types:\n\nURL - Websites and web links\nText - Plain text messages\nWiFi - WiFi network credentials\nvCard - Contact information (VCF format)\nEmail - Email addresses with optional subject/body\nPhone - Phone numbers (tel: links)\nSMS - SMS messages with recipient and text\nGeo - Geographic coordinates\nEvent - Calendar events (iCal format)\nCustom - Any custom data\n2. Customization Options\n\nPersonalize QR code appearance:\n\nForeground and background colors\nCustom error correction levels\nBorder size adjustment\nModule size control\nLogo/image embedding\n3. Multiple Export Formats\n\nExport in various formats for different use cases:\n\nPNG - Raster images (default)\nSVG - Vector graphics (scalable)\nPDF - Print-ready documents\nEPS - Vector format for design tools\nTerminal - ASCII art for terminal display\n4. Batch Processing\n\nGenerate multiple QR codes from:\n\nText files (one entry per line)\nCSV files (with metadata)\nJSON files (with configuration)\nBasic Usage\nURL QR Codes\n\nGenerate QR codes for websites and links.\n\n# Simple URL\npython scripts/qr.py \"https://example.com\"\n\n# With custom filename\npython scripts/qr.py \"https://github.com\" --output github_qr.png\n\n# High error correction for printed codes\npython scripts/qr.py \"https://mysite.com\" --error-correction H --output site_qr.png\n\n\nOutput:\n\nQR code generated: qrcode.png\nSize: 290x290 pixels\nError correction: M (Medium)\nData: https://example.com\n\nText QR Codes\n\nEncode plain text messages.\n\n# Simple text\npython scripts/qr.py --type text \"Hello, World!\"\n\n# Multi-line text\npython scripts/qr.py --type text \"Line 1\\nLine 2\\nLine 3\" --output message.png\n\n# Large text (automatic size adjustment)\npython scripts/qr.py --type text \"$(cat message.txt)\" --output text_qr.png\n\nWiFi QR Codes\n\nCreate scannable WiFi credentials.\n\n# WPA/WPA2 network\npython scripts/qr.py --type wifi --ssid \"MyNetwork\" --password \"SecurePassword123\"\n\n# WPA2 network (explicit)\npython scripts/qr.py --type wifi --ssid \"HomeWiFi\" --password \"pass123\" --security WPA\n\n# Hidden network\npython scripts/qr.py --type wifi --ssid \"SecretNet\" --password \"secret\" --hidden\n\n# Open network (no password)\npython scripts/qr.py --type wifi --ssid \"GuestNetwork\" --security nopass\n\n\nSecurity types: WPA, WEP, nopass\n\nOutput QR contains:\n\nWIFI:T:WPA;S:MyNetwork;P:SecurePassword123;H:false;;\n\nContact Cards (vCard)\n\nGenerate vCard QR codes for easy contact sharing.\n\n# Basic contact\npython scripts/qr.py --type vcard --name \"John Doe\" --phone \"+1234567890\"\n\n# Full contact details\npython scripts/qr.py --type vcard \\\n --name \"Jane Smith\" \\\n --phone \"+1234567890\" \\\n --email \"jane@example.com\" \\\n --organization \"Tech Corp\" \\\n --title \"Senior Developer\" \\\n --url \"https://janesmith.com\" \\\n --address \"123 Main St, City, State, 12345\" \\\n --output jane_contact.png\n\n# Multiple phone numbers\npython scripts/qr.py --type vcard \\\n --name \"Bob Johnson\" \\\n --phone \"+1234567890\" \\\n --phone-home \"+0987654321\" \\\n --email \"bob@email.com\"\n\n\nGenerated vCard format:\n\nBEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nTEL:+1234567890\nEND:VCARD\n\nEmail QR Codes\n\nCreate mailto: links with optional subject and body.\n\n# Simple email\npython scripts/qr.py --type email --email \"contact@example.com\"\n\n# With subject\npython scripts/qr.py --type email --email \"support@company.com\" --subject \"Support Request\"\n\n# With subject and body\npython scripts/qr.py --type email \\\n --email \"info@example.com\" \\\n --subject \"Inquiry\" \\\n --body \"I would like more information about...\"\n\n\nOutput QR contains:\n\nmailto:contact@example.com?subject=Support%20Request&body=Message%20text\n\nPhone Number QR Codes\n\nGenerate clickable phone links.\n\n# Simple phone number\npython scripts/qr.py --type phone --phone \"+1234567890\"\n\n# International format\npython scripts/qr.py --type phone --phone \"+44 20 7946 0958\"\n\n\nOutput QR contains:\n\ntel:+1234567890\n\nSMS QR Codes\n\nCreate pre-filled SMS messages.\n\n# SMS with recipient only\npython scripts/qr.py --type sms --phone \"+1234567890\"\n\n# SMS with message\npython scripts/qr.py --type sms --phone \"+1234567890\" --message \"Hello from QR code!\"\n\n\nOutput QR contains:\n\nsms:+1234567890?body=Hello%20from%20QR%20code!\n\nGeographic Location QR Codes\n\nEncode GPS coordinates.\n\n# Coordinates only\npython scripts/qr.py --type geo --latitude 37.7749 --longitude -122.4194\n\n# With altitude\npython scripts/qr.py --type geo --latitude 40.7128 --longitude -74.0060 --altitude 10\n\n# Named location\npython scripts/qr.py --type geo --latitude 51.5074 --longitude -0.1278 --location-name \"London\"\n\n\nOutput QR contains:\n\ngeo:37.7749,-122.4194\n\nCalendar Event QR Codes\n\nGenerate iCalendar event QR codes.\n\n# Basic event\npython scripts/qr.py --type event \\\n --event-title \"Team Meeting\" \\\n --event-start \"2024-03-15T14:00:00\" \\\n --event-end \"2024-03-15T15:00:00\"\n\n# Full event details\npython scripts/qr.py --type event \\\n --event-title \"Conference 2024\" \\\n --event-start \"2024-06-01T09:00:00\" \\\n --event-end \"2024-06-01T17:00:00\" \\\n --event-location \"Convention Center, NYC\" \\\n --event-description \"Annual tech conference\" \\\n --output conference_qr.png\n\nCustomization Options\nColors\n\nCustomize foreground and background colors.\n\n# Named colors\npython scripts/qr.py \"https://example.com\" --fg-color blue --bg-color white\n\n# Hex colors\npython scripts/qr.py \"https://example.com\" --fg-color \"#FF0000\" --bg-color \"#FFFFFF\"\n\n# RGB colors\npython scripts/qr.py \"https://example.com\" --fg-color \"rgb(0,100,200)\" --bg-color \"rgb(255,255,255)\"\n\n# Transparent background\npython scripts/qr.py \"https://example.com\" --bg-color transparent --format png\n\n\nCommon color names: black, white, red, blue, green, yellow, orange, purple, pink, brown, gray\n\nError Correction\n\nSet error correction level (higher = more damage resistance).\n\n--error-correction \n\n\nLevels:\n\nL - Low (~7% recovery) - Use for digital display\nM - Medium (~15% recovery) - Default, good balance\nQ - Quartile (~25% recovery) - Use when adding logos\nH - High (~30% recovery) - Best for print, damaged surfaces\n# Low (smallest QR code)\npython scripts/qr.py \"https://example.com\" --error-correction L\n\n# High (best for print with logo)\npython scripts/qr.py \"https://example.com\" --error-correction H --logo company.png\n\nSize and Border\n\nControl QR code size and border width.\n\n# Custom module size (box size in pixels)\npython scripts/qr.py \"URL\" --box-size 20\n\n# Custom border (modules)\npython scripts/qr.py \"URL\" --border 2\n\n# Large QR code\npython scripts/qr.py \"URL\" --box-size 30 --border 4 --output large_qr.png\n\n# Minimal QR code (no border)\npython scripts/qr.py \"URL\" --border 0 --output minimal_qr.png\n\n\nDefaults:\n\nBox size: 10 pixels\nBorder: 4 modules (recommended minimum)\nLogo Embedding\n\nAdd logos or images to QR codes.\n\n# Add logo (center)\npython scripts/qr.py \"https://company.com\" --logo company_logo.png\n\n# Custom logo size (percentage of QR code)\npython scripts/qr.py \"URL\" --logo logo.png --logo-size 20\n\n# High error correction recommended with logos\npython scripts/qr.py \"URL\" --logo logo.png --error-correction H\n\n\nLogo tips:\n\nUse square or circular logos\nKeep logo size ≤ 30% of QR code\nUse high error correction (Q or H)\nTest scanning after adding logo\nExport Formats\nPNG (Default)\n\nRaster image format, good for digital use.\n\npython scripts/qr.py \"https://example.com\" --format png --output qr.png\n\n\nBest for: Web, digital displays, simple sharing\n\nSVG (Vector)\n\nScalable vector graphics, perfect for any size.\n\npython scripts/qr.py \"https://example.com\" --format svg --output qr.svg\n\n\nBest for: Print, design work, scaling to any size\n\nPDF\n\nPrint-ready PDF documents.\n\npython scripts/qr.py \"https://example.com\" --format pdf --output qr.pdf\n\n\nBest for: Printing, documents, archival\n\nEPS\n\nEncapsulated PostScript for professional design tools.\n\npython scripts/qr.py \"https://example.com\" --format eps --output qr.eps\n\n\nBest for: Professional design software (Adobe Illustrator, etc.)\n\nTerminal\n\nDisplay QR code as ASCII art in terminal.\n\npython scripts/qr.py \"https://example.com\" --format terminal\n\n\nOutput:\n\n█████████████████████████████\n█████████████████████████████\n████ ▄▄▄▄▄ █▀█ █▄▄▄▄▄ ████\n████ █ █ █▀▀▀█ █ █ ████\n████ █▄▄▄█ █▀ ▀ █▄▄▄█ ████\n...\n\n\nBest for: Quick terminal display, debugging\n\nBatch Generation\nFrom Text File\n\nGenerate QR codes from a list of URLs or text.\n\n# Create input file\ncat > urls.txt << EOF\nhttps://example.com\nhttps://github.com\nhttps://google.com\nEOF\n\n# Generate batch\npython scripts/qr.py --batch urls.txt --output-dir qrcodes/\n\n\nOutput:\n\nqrcodes/\n ├── qr_001.png\n ├── qr_002.png\n └── qr_003.png\n\nFrom CSV File\n\nGenerate with metadata (filenames, options).\n\n# Create CSV\ncat > contacts.csv << EOF\nname,phone,email,filename\nJohn Doe,+1234567890,john@example.com,john_qr.png\nJane Smith,+0987654321,jane@example.com,jane_qr.png\nEOF\n\n# Generate batch\npython scripts/qr.py --batch contacts.csv --type vcard --output-dir contacts/\n\nFrom JSON File\n\nGenerate with full customization per QR code.\n\n# Create JSON config\ncat > qr_config.json << EOF\n[\n {\n \"data\": \"https://example.com\",\n \"output\": \"example_qr.png\",\n \"fg_color\": \"blue\",\n \"bg_color\": \"white\"\n },\n {\n \"type\": \"wifi\",\n \"ssid\": \"MyNetwork\",\n \"password\": \"secret\",\n \"output\": \"wifi_qr.png\"\n }\n]\nEOF\n\n# Generate batch\npython scripts/qr.py --batch qr_config.json --output-dir custom/\n\nCommon Workflows\nEvent Check-In System\n\nGenerate QR codes for event tickets.\n\n# Create ticket QR codes with unique IDs\npython scripts/qr.py --type text \"TICKET-001-VIP\" --output tickets/ticket_001.png\npython scripts/qr.py --type text \"TICKET-002-GENERAL\" --output tickets/ticket_002.png\n\n# Or batch from CSV\ncat > tickets.csv << EOF\nticket_id,type,name\nTICKET-001,VIP,John Doe\nTICKET-002,GENERAL,Jane Smith\nEOF\n\npython scripts/qr.py --batch tickets.csv --template \"TICKET-{ticket_id}-{type}\" --output-dir tickets/\n\nRestaurant Menu\n\nCreate QR code for digital menu.\n\n# Menu URL\npython scripts/qr.py \"https://restaurant.com/menu\" \\\n --output menu_qr.png \\\n --box-size 15 \\\n --error-correction H\n\n# Print version (PDF)\npython scripts/qr.py \"https://restaurant.com/menu\" \\\n --format pdf \\\n --output menu_qr.pdf \\\n --box-size 20\n\nWiFi Guest Access\n\nGenerate WiFi QR code for guests.\n\n# Print-friendly version\npython scripts/qr.py --type wifi \\\n --ssid \"Guest_Network\" \\\n --password \"GuestPass123\" \\\n --format pdf \\\n --output wifi_guest.pdf \\\n --box-size 15 \\\n --error-correction H\n\n# Poster with logo\npython scripts/qr.py --type wifi \\\n --ssid \"Guest_Network\" \\\n --password \"GuestPass123\" \\\n --logo company_logo.png \\\n --output wifi_poster.png \\\n --box-size 20\n\nContact Card Distribution\n\nCreate scannable business cards.\n\n# Generate vCard\npython scripts/qr.py --type vcard \\\n --name \"John Doe\" \\\n --phone \"+1234567890\" \\\n --email \"john@company.com\" \\\n --organization \"Tech Corp\" \\\n --title \"CEO\" \\\n --url \"https://company.com\" \\\n --format svg \\\n --output business_card.svg\n\n# Print version\npython scripts/qr.py --type vcard \\\n --name \"John Doe\" \\\n --phone \"+1234567890\" \\\n --email \"john@company.com\" \\\n --format pdf \\\n --output business_card.pdf \\\n --box-size 12\n\nProduct Packaging\n\nQR codes for product information.\n\n# Product info URL\npython scripts/qr.py \"https://product.com/info/SKU12345\" \\\n --output product_qr.svg \\\n --format svg \\\n --fg-color \"#000000\" \\\n --bg-color transparent\n\n# With error correction for damaged packaging\npython scripts/qr.py \"https://product.com/info/SKU12345\" \\\n --error-correction H \\\n --output product_qr_robust.png\n\nSocial Media Links\n\nQR codes for social profiles.\n\n# Instagram\npython scripts/qr.py \"https://instagram.com/username\" --output instagram_qr.png\n\n# LinkedIn\npython scripts/qr.py \"https://linkedin.com/in/username\" --output linkedin_qr.png\n\n# Multiple platforms (batch)\ncat > social.txt << EOF\nhttps://twitter.com/username\nhttps://instagram.com/username\nhttps://linkedin.com/in/username\nhttps://github.com/username\nEOF\n\npython scripts/qr.py --batch social.txt --output-dir social_qr/\n\nPayment Links\n\nQR codes for payment services.\n\n# PayPal\npython scripts/qr.py \"https://paypal.me/username\" --output paypal_qr.png\n\n# Venmo\npython scripts/qr.py \"venmo://username\" --output venmo_qr.png\n\n# Cash App\npython scripts/qr.py \"https://cash.app/$username\" --output cashapp_qr.png\n\nBest Practices\nSize and Scanning\nMinimum size: 2cm × 2cm for reliable scanning\nViewing distance: QR size should be 10% of scanning distance\nBorder: Keep at least 4 modules border (quiet zone)\nTesting: Always test scan before printing\nError Correction\nDigital display: Use L or M\nPrint without logo: Use M\nPrint with logo: Use H\nOutdoor/damaged: Use H\nColors\nHigh contrast: Dark foreground, light background\nAvoid: Light colors on light, dark on dark\nPrint: Use pure black/white for best results\nBranding: Test custom colors before mass production\nLogo Integration\nSize: Keep logo ≤ 25-30% of QR code\nError correction: Use Q or H level\nPosition: Center placement works best\nTesting: Verify scanning with logo\nFile Formats\nDigital: PNG for web, screens\nPrint: PDF or SVG for scalability\nDesign: SVG or EPS for editing\nArchive: Keep source data and SVG version\nTroubleshooting\nInstallation Issues\n\n\"Missing required dependency\"\n\n# Install dependencies\npip install qrcode[pil] segno\n\n# Or use virtual environment\npython -m venv venv\nsource venv/bin/activate\npip install qrcode[pil] segno\n\n\n\"PIL/Pillow not found\"\n\npip install Pillow\n\nGeneration Issues\n\n\"QR code too complex\"\n\nReduce data size\nUse higher version (auto-adjusts)\nSplit into multiple QR codes\n\n\"Cannot scan QR code\"\n\nIncrease error correction\nEnsure sufficient contrast\nCheck minimum size\nRemove or reduce logo size\nTest in good lighting\n\n\"Logo obscures data\"\n\nReduce logo size (--logo-size)\nIncrease error correction to H\nUse simpler logo design\nFile Issues\n\n\"Cannot save file\"\n\nCheck output directory exists\nVerify write permissions\nCheck disk space\n\n\"Invalid color format\"\n\nUse named colors: red, blue, green\nUse hex: #RRGGBB\nUse rgb: rgb(R,G,B)\nCommand Reference\npython scripts/qr.py [DATA] [OPTIONS]\n\nDATA:\n Text string, URL, or data to encode (required unless using --batch)\n\nGENERAL OPTIONS:\n --type Data type (url|text|wifi|vcard|email|phone|sms|geo|event)\n -o, --output Output filename (default: qrcode.png)\n -f, --format Format (png|svg|pdf|eps|terminal)\n \nCUSTOMIZATION:\n --fg-color Foreground color (default: black)\n --bg-color Background color (default: white)\n --error-correction Error correction (L|M|Q|H, default: M)\n --box-size Module size in pixels (default: 10)\n --border Border size in modules (default: 4)\n --logo Logo image path\n --logo-size Logo size percentage (default: 20)\n\nWIFI OPTIONS:\n --ssid Network SSID\n --password Network password\n --security Security type (WPA|WEP|nopass)\n --hidden Hidden network flag\n\nVCARD OPTIONS:\n --name Full name\n --phone Phone number\n --phone-home Home phone\n --phone-work Work phone\n --email Email address\n --organization Company/organization\n --title Job title\n --url Website URL\n --address Full address\n\nEMAIL OPTIONS:\n --email Email address\n --subject Email subject\n --body Email body\n\nPHONE/SMS OPTIONS:\n --phone Phone number\n --message SMS message text\n\nGEO OPTIONS:\n --latitude Latitude coordinate\n --longitude Longitude coordinate\n --altitude Altitude (optional)\n --location-name Location name (optional)\n\nEVENT OPTIONS:\n --event-title Event title\n --event-start Start datetime (ISO format)\n --event-end End datetime (ISO format)\n --event-location Event location\n --event-description Event description\n\nBATCH OPTIONS:\n --batch Input file (txt|csv|json)\n --output-dir Output directory for batch\n --template Filename template for batch\n\nHELP:\n --help Show all options\n\nExamples by Use Case\nQuick QR Codes\n# URL\npython scripts/qr.py \"https://example.com\"\n\n# Text\npython scripts/qr.py --type text \"Hello World\"\n\n# Phone\npython scripts/qr.py --type phone --phone \"+1234567890\"\n\nProfessional QR Codes\n# With logo and custom colors\npython scripts/qr.py \"https://company.com\" \\\n --logo logo.png \\\n --fg-color \"#003366\" \\\n --bg-color \"#FFFFFF\" \\\n --error-correction H \\\n --output company_qr.png\n\n# Print-ready\npython scripts/qr.py \"https://company.com\" \\\n --format pdf \\\n --box-size 15 \\\n --error-correction H \\\n --output printable_qr.pdf\n\nFunctional QR Codes\n# WiFi access\npython scripts/qr.py --type wifi --ssid \"Network\" --password \"pass123\"\n\n# Contact card\npython scripts/qr.py --type vcard --name \"John Doe\" --phone \"+1234567890\" --email \"john@example.com\"\n\n# Calendar event\npython scripts/qr.py --type event --event-title \"Meeting\" --event-start \"2024-03-15T14:00:00\" --event-end \"2024-03-15T15:00:00\"\n\nBulk Generation\n# From URL list\npython scripts/qr.py --batch urls.txt --output-dir qrcodes/\n\n# From CSV with metadata\npython scripts/qr.py --batch data.csv --output-dir output/\n\n# Custom configuration per code\npython scripts/qr.py --batch config.json --output-dir custom/\n\nSupport\n\nFor issues or questions:\n\nCheck this documentation\nRun python scripts/qr.py --help\nVerify dependencies are installed\nTest with simple QR code first\n\nResources:\n\nOpenClawCLI: https://clawhub.ai/\nqrcode library: https://pypi.org/project/qrcode/\nsegno library: https://pypi.org/project/segno/\nQR code specification: ISO/IEC 18004" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/anisafifi/qr-code-generator", "publisherUrl": "https://clawhub.ai/anisafifi/qr-code-generator", "owner": "anisafifi", "version": "0.1.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/qr-code-generator", "downloadUrl": "https://openagent3.xyz/downloads/qr-code-generator", "agentUrl": "https://openagent3.xyz/skills/qr-code-generator/agent", "manifestUrl": "https://openagent3.xyz/skills/qr-code-generator/agent.json", "briefUrl": "https://openagent3.xyz/skills/qr-code-generator/agent.md" } }