zedbar

Fast QR code and barcode scanner for Node.js, powered by WebAssembly.

A port of the ZBar barcode scanning library from C to Rust, compiled to WebAssembly for use in Node.js.

Features

• Fast: Native-speed scanning via WebAssembly
• No native dependencies: Works on any platform Node.js supports
• Multiple formats: QR Code, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 93, Code 39, Codabar, Interleaved 2 of 5, DataBar, SQ Code
• CLI tool: Command-line zedbarimg binary for scanning images (similar to zbarimg)

Installation

npm install zedbar

Command-line Usage

The package includes a zedbarimg command-line tool:

# Scan a single image
zedbarimg barcode.png

# Scan multiple images
zedbarimg image1.png image2.jpg image3.webp

# Quiet mode (only output barcode data)
zedbarimg --quiet qrcode.png

# Show help
zedbarimg --help

After installing globally, you can use it directly:

npm install -g zedbar
zedbarimg barcode.png

Library Usage

Scan from image file bytes

import { scanImageBytes } from 'zedbar';
import { readFileSync } from 'fs';

// Read image file (PNG, JPEG, WebP, BMP)
const imageBytes = readFileSync('barcode.png');

// Scan for barcodes
for (const { symbolType, text } of scanImageBytes(imageBytes)) {
  console.log(`${symbolType}: ${text}`);
}

Scan from grayscale data

If you already have grayscale image data:

import { scanGrayscale } from 'zedbar';

// data is Uint8Array of grayscale pixels (1 byte per pixel, row-major)
for (const { symbolType, text } of scanGrayscale(data, width, height)) {
  console.log(`${symbolType}: ${text}`);
}

API

scanImageBytes(bytes, options?)

Scans an encoded image (PNG, JPEG, WebP, BMP) for barcodes and QR codes.

Parameters:

• bytes (Uint8Array or Buffer) - Raw bytes of an image file
• options (ScanOptions, optional) - Scanning options

Returns: DecodeResult[] - Array of decoded barcodes

scanGrayscale(data, width, height, options?)

Scans grayscale image data for barcodes and QR codes.

Parameters:

• data (Uint8Array) - Grayscale pixel data, 1 byte per pixel, row-major order
• width (number) - Image width in pixels
• height (number) - Image height in pixels
• options (ScanOptions, optional) - Scanning options

Returns: DecodeResult[] - Array of decoded barcodes

ScanOptions

• retryUndecodedRegions (boolean, default: true) - Automatically retry undecoded QR finder regions by cropping and upscaling. Disable to skip the retry and reduce processing time for images that are known to have sufficient resolution.
• symbologies (string[], optional) - Restrict scanning to the listed symbologies. When omitted, every supported symbology is enabled. Names match the symbolType field on results — see Supported Formats.

// Scan QR codes only
const results = scanImageBytes(imageBytes, { symbologies: ['QR-Code'] });

DecodeResult

• symbolType (string) - Barcode format (e.g., "QR-Code", "EAN-13")
• data (Uint8Array) - Raw decoded bytes
• text (string | undefined) - Decoded data as UTF-8 string, or undefined if not valid UTF-8
• points (Point[]) - Position points in image coordinates. For QR codes, the four corners of the QR's bounding rectangle (in implementation-defined order). For linear barcodes, one or more touchpoints accumulated as the symbol was scanned. Empty if no points were recorded.
• bounds (Bounds | undefined) - Axis-aligned bounding rectangle of points, or undefined if no points were recorded.

Point

• x (number)
• y (number)

Bounds

• x, y (number) - Top-left corner in image coordinates.
• width, height (number) - Reported as max - min of the recorded points (the horizontal and vertical extent between the outermost points), not as a pixel count.

for (const result of scanImageBytes(imageBytes)) {
  for (const { x, y } of result.points) {
    console.log(`  point at (${x}, ${y})`);
  }
  if (result.bounds) {
    const { x, y, width, height } = result.bounds;
    console.log(`  bounds: ${width}×${height} at (${x}, ${y})`);
  }
}

Supported Formats

| Format | symbolType | |--------|-------------| | QR Code | QR-Code | | EAN-13 | EAN-13 | | EAN-8 | EAN-8 | | UPC-A | UPC-A | | UPC-E | UPC-E | | Code 128 | CODE-128 | | Code 93 | CODE-93 | | Code 39 | CODE-39 | | Codabar | Codabar | | Interleaved 2 of 5 | I2/5 | | DataBar | DataBar | | SQ Code | SQ-Code |

License

LGPL-3.0-or-later

Based on the ZBar library. See GitHub for source code.