Qr Decoder

--- name: qr-decoder description: "Decode QR codes from images. Extract URLs, text, WiFi credentials, vCard contacts. Uses zbar or libdecodeqr. No API key required."

QR Decoder Skill

Decode and extract data from QR codes in image files.

When to Use

✅ USE this skill when:

• "Read this QR code"
• "Decode QR from image"
• "Extract URL from QR code"
• "Scan QR code image"
• "What's in this QR code?"

When NOT to Use

❌ DON'T use this skill when:

• Creating QR codes ΓåÆ use qr-generator
• Interactive camera scanning ΓåÆ use browser-tools
• Need real-time decoding ΓåÆ use native tools

Commands

Decode from File

{baseDir}/decode.sh <image_file>
{baseDir}/decode.sh qrcode.png
{baseDir}/decode.sh photo.jpg

Decode Multiple Files

{baseDir}/decode.sh *.png
{baseDir}/decode.sh --dir ./images --pattern "*.jpg"

Output Formats

{baseDir}/decode.sh qrcode.png --format text
{baseDir}/decode.sh qrcode.png --format json
{baseDir}/decode.sh qrcode.png --format raw
{baseDir}/decode.sh qrcode.png --format qr-type

Batch Processing

{baseDir}/decode.sh --batch images.txt
{baseDir}/decode.sh --dir ./qrcodes --output results.json

From URL

{baseDir}/decode.sh --url "https://example.com/qrcode.png"
{baseDir}/decode.sh --url "https://example.com/qrcode.png" --save temp.png

From Webcam (if supported)

{baseDir}/decode.sh --camera
{baseDir}/decode.sh --camera --device /dev/video0

Options

QR Code Types

The skill can decode:

Output Format (JSON)

{
  "file": "qrcode.png",
  "type": "URL",
  "data": "https://example.com",
  "parsed": {
    "url": "https://example.com",
    "domain": "example.com",
    "scheme": "https"
  },
  "position": {
    "x": 100,
    "y": 100,
    "width": 200,
    "height": 200
  }
}

Examples

Decode a QR code:

{baseDir}/decode.sh qrcode.png
# https://example.com

Get QR type:

{baseDir}/decode.sh qrcode.png --format qr-type
# URL

Decode WiFi credentials:

{baseDir}/decode.sh wifi.png
# WIFI:S:MyNetwork;T:WPA;P:password123;;

Parse as JSON:

{baseDir}/decode.sh qrcode.png --format json | jq '.data'

Decode from URL:

{baseDir}/decode.sh --url "https://example.com/qr.png"

Batch decode directory:

{baseDir}/decode.sh --dir ./qrcodes --format json --output results.json

Find all QR codes in image:

{baseDir}/decode.sh photo.jpg --multi

Parsed Output

For recognized formats (WiFi, vCard, URL, etc.), the skill provides parsed output:

WiFi QR:

Type: WIFI
SSID: MyNetwork
Security: WPA
Password: password123
Hidden: No

vCard QR:

Type: VCARD
Name: John Doe
Phone: +1234567890
Email: john@example.com
Organization: Example Corp

Exit Codes

• 0: Successfully decoded
• 1: No QR code found
• 2: Invalid image file
• 3: Dependency missing (zbar not installed)
• 4: Network error (for --url)

Dependencies

• zbarimg (recommended): Primary decoder, handles most formats
• libdecodeqr: Alternative decoder
• fswebcam: For camera capture

Install on Debian/Ubuntu:

sudo apt install zbar-tools