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

Option	Description	Default
--format FORMAT	Output format: text, json, raw, qr-type	text
--dir DIR	Process all images in directory	None
--pattern GLOB	File pattern for --dir	*.{png,jpg,jpeg,gif}
--batch FILE	Read image paths from file	None
--url URL	Decode from URL	None
--save FILE	Save downloaded image	None
--camera	Use camera for live decode	false
--device DEVICE	Camera device path	/dev/video0
--output FILE	Output to file	stdout
--multi	Return all QR codes found	first only
--quiet	Suppress errors	false

QR Code Types

The skill can decode:

Type	Description	Example
URL	Website links	https://example.com
TEXT	Plain text	Any text content
WIFI	WiFi credentials	WIFI:S:MyNetwork;T:WPA;P:password;;
VEVENT	Calendar event	iCalendar format
VCARD	Contact card	vCard format
EMAIL	Email address	mailto:user@example.com
TEL	Phone number	tel:+1234567890
SMS	SMS message	sms:+1234567890?body=Hello
GEO	Geographic location	geo:40.7128,-74.0060

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