n8n-nodes-qrcode-scan
v0.2.1
Published
n8n community node for scanning QR codes from images
Maintainers
Readme
n8n-nodes-qrcode-scan
This is an n8n community node that lets you scan QR codes from images in your n8n workflows.
The QR Code Scanner node can extract text and data from QR codes in various image formats, supporting multiple input methods including URLs, base64 data, and binary data from previous nodes.
n8n is a fair-code licensed workflow automation platform.
Installation Operations Compatibility Usage Resources Version history
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
The QR Code Scanner node supports the following operations:
- Scan QR Code: Extract data from QR codes in images
- Input Types:
- Image URL: Provide a direct URL to an image containing a QR code
- Base64 Image Data: Provide base64 encoded image data (with or without data URL prefix)
- Binary Data: Use binary data from previous nodes in the workflow
- Output Formats:
- Simple Text: Returns only the decoded text content
- Detailed Object: Returns comprehensive information including location data, error correction level, and version
- Input Types:
Credentials
No credentials are required for this node.
Compatibility
This node is compatible with n8n version 1.0.0 and above. It has been tested with the latest versions of n8n.
Usage
Basic Usage
- Add the QR Code Scanner node to your workflow
- Choose your input type:
- For Image URL: Enter the direct URL to an image containing a QR code
- For Base64 Data: Paste base64 encoded image data (supports data URLs like
data:image/png;base64,iVBORw0...) - For Binary Data: Connect from a previous node that outputs image binary data
- Select output format:
- Simple Text: Get just the decoded QR code content
- Detailed Object: Get comprehensive information including location coordinates and technical details
- Execute the workflow to scan the QR code
Example Workflows
- URL Processing: HTTP Request → QR Code Scanner → Process extracted data
- File Upload: Manual Trigger → QR Code Scanner (binary) → Database storage
- Batch Processing: Read Binary Files → QR Code Scanner → CSV output
Error Handling
The node includes comprehensive error handling:
- Invalid image formats will return descriptive error messages
- Missing QR codes will be reported clearly
- Network errors for URL fetching are handled gracefully
- Use the "Continue on Fail" option to process multiple images in batch operations
Resources
- n8n community nodes documentation
- jsQR library documentation - The QR code scanning library used by this node
- Jimp library documentation - Pure JavaScript image processing library
- QR Code specification - ISO/IEC 18004:2015 standard
Version history
0.2.0
- BREAKING CHANGE: Replaced Canvas dependency with Jimp for pure JavaScript implementation
- Eliminated native dependencies - now works across all platforms without compilation
- Improved compatibility and easier installation
- Same functionality with better cross-platform support
0.1.0
- Initial release
- Support for scanning QR codes from images via URL, base64 data, and binary data
- Simple text and detailed object output formats
- Comprehensive error handling and metadata reporting
- Support for various image formats (PNG, JPEG, GIF, etc.)
