Installation

From crates.io (recommended)

cargo install qrcode-ai-scanner-cli

From GitHub

cargo install --git https://github.com/supernovae-st/qrcode-ai-scanner qrcode-ai-scanner-cli

Build from source

git clone https://github.com/supernovae-st/qrcode-ai-scanner.git
cd qrcode-ai-scanner
cargo build --release -p qrcode-ai-scanner-cli
# Binary at: target/release/qrcode-ai

Add to PATH (after building)

# macOS/Linux
sudo cp target/release/qrcode-ai /usr/local/bin/

# Or add to your shell profile
echo 'export PATH="$PATH:/path/to/qrcode-ai-scanner/target/release"' >> ~/.zshrc

Usage

Basic Validation

# Full validation with visual output
qrcode-ai image.png

# JSON output
qrcode-ai -j image.png

# Score only (for scripts)
qrcode-ai -s image.png
# Output: 85

Fast Mode

# Reduced stress tests (~2x faster)
qrcode-ai -f image.png

Decode Only

# Skip stress tests, just decode
qrcode-ai -d image.png

Timing Information

# Show processing time
qrcode-ai -t image.png

Quiet Mode

# Minimal output
qrcode-ai -q image.png

Options

Examples

Scripting

# Check if QR is production-ready (score >= 70)
if [ $(qrcode-ai -s image.png) -ge 70 ]; then
    echo "Production ready!"
fi

# Batch process directory
for f in *.png; do
    score=$(qrcode-ai -s "$f")
    echo "$f: $score"
done

CI/CD Integration

# GitHub Actions / GitLab CI
- name: Validate QR codes
  run: |
    for qr in assets/qr/*.png; do
      score=$(qrcode-ai -s "$qr")
      if [ $score -lt 70 ]; then
        echo "❌ $qr failed with score $score"
        exit 1
      fi
      echo "✅ $qr passed with score $score"
    done

JSON Processing

# Extract content with jq
qrcode-ai -j image.png | jq -r '.content'

# Get all stress test results
qrcode-ai -j image.png | jq '.stress_results'

Output Format

Visual (default)

  ╔══════════════════════════════════════════════════════════════════╗
  ║  🌟  SCANNABILITY SCORE: 100                                   ║
  ╚══════════════════════════════════════════════════════════════════╝

  📄 File:    image.png
  ⏱  Time:    54ms

  📝 DECODED CONTENT
  https://example.com

  🧪 STRESS TEST RESULTS
   ✓ Original             [PASS]
   ✓ Downscale 50%        [PASS]
   ✓ Downscale 25%        [PASS]
   ✓ Blur (light)         [PASS]
   ✓ Blur (medium)        [PASS]
   ✓ Low Contrast         [PASS]

  📊 QR METADATA
   Version:          v2   (size complexity)
   Error Correction: M    (~15% recovery)
   Modules:          25x25  (grid size)
   Decoders:         rxing, rqrr

JSON (-j)

{
  "score": 100,
  "decodable": true,
  "content": "https://example.com",
  "metadata": {
    "version": 2,
    "error_correction": "M",
    "modules": 25,
    "decoders_success": ["rxing", "rqrr"]
  },
  "stress_results": {
    "original": true,
    "downscale_50": true,
    "downscale_25": true,
    "blur_light": true,
    "blur_medium": true,
    "low_contrast": true
  }
}

Exit Codes

License

AGPL-3.0

Part of QR Code AI by Thibaut MÉLEN & SuperNovae Studio