flutter_zxing 1.8.2

A barcode scanner and generator natively in Flutter with Dart FFI based on ZXing.

Flutter ZXing

Flutter ZXing is a high-performance Flutter plugin for scanning and generating QR codes and barcodes. Built on the powerful ZXing C++ library, it provides fast and reliable barcode processing capabilities for Flutter applications. Whether you need to scan barcodes from the camera or generate custom QR codes, Flutter ZXing makes it seamless and efficient.

---

Table of Contents

• Flutter ZXing
  • Table of Contents
  • Demo Screenshots
  • Features
  • Supported Formats
  • Supported Platforms
  • ZXScanner
    • Features
    • Try ZXScanner
  • Getting Started
    • Cloning the flutter_zxing project
    • Installing dependencies
  • Usage
    • To read barcode
    • To create barcode
  • License

---

Demo Screenshots

Left: Barcode Scanner, Right: QR Code Creator

---

Features

• Scan QR codes and barcodes from the camera stream (on mobile platforms only), image file, or URL.
• Scan multiple barcodes at once from the camera stream (on mobile platforms only), image file, or URL.
• Generate QR codes with customizable content and size.
• Return the position points of the scanned barcode.
• Customizable scanner frame size and color, and the ability to enable or disable features like torch and pinch to zoom.

---

Supported Formats

Linear product	Linear industrial	Matrix
UPC-A	Code 39	QR Code
UPC-E	Code 93	Micro QR Code
EAN-8	Code 128	rMQR Code
EAN-13	Codabar	Aztec
DataBar	DataBar Expanded	DataMatrix
	ITF	PDF417
		MaxiCode (partial)

---

Supported Platforms

Platform	Status	Notes
Android	✅ Fully Supported	Minimum API level 21
iOS	✅ Fully Supported	Minimum iOS 11.0
MacOS	⚠️ Beta	Minimum macOS 10.15
Linux	⚠️ Beta	No camera support
Windows	⚠️ Beta	No camera support
Web	❌ Not Supported	Dart FFI is not available on the web

Note: Flutter ZXing relies on the Dart FFI feature, making it unsupported on the web. Camera-based scanning is only available on mobile platforms.

---

ZXScanner

ZXScanner is a free QR code and barcode scanner app for Android and iOS. It is built using Flutter and the flutter_zxing plugin.

Features

• Fast and reliable QR code and barcode scanning.
• Built-in support for multiple barcode formats.
• Fully open-source and customizable.

Try ZXScanner

To learn more or contribute, visit the ZXScanner repository.

Getting Started

Cloning the flutter_zxing project

To clone the flutter_zxing project from Github which includes submodules, use the following command:

git clone --recursive https://github.com/khoren93/flutter_zxing.git

Installing dependencies

Use Melos to install the dependencies of the flutter_zxing project. Melos is a tool that helps you manage multiple Dart packages in a single repository. To install Melos, use the following command:

flutter pub global activate melos

To install the dependencies of the flutter_zxing project, use the following command:

melos bootstrap

To allow the building on iOS and MacOS, you need to run the following command:

./scripts/update_ios_macos_src.sh

To run the integration tests:

cd example
flutter test integration_test

Now you can run the flutter_zxing example app on your device or emulator.

Usage

To read barcode

import 'package:flutter_zxing/flutter_zxing.dart';

// Use ReaderWidget to quickly read barcode from camera image
@override
Widget build(BuildContext context) {
  return Scaffold(
    body: ReaderWidget(
      onScan: (result) async {
        // Do something with the result
      },
    ),
  );
}

// Or use flutter_zxing plugin methods 
// To read barcode from camera image directly
await zx.startCameraProcessing(); // Call this in initState

cameraController?.startImageStream((image) async {
    Code result = await zx.processCameraImage(image);
    if (result.isValid) {
        debugPrint(result.text);
    }
    return null;
});

zx.stopCameraProcessing(); // Call this in dispose

// To read barcode from XFile, String, url or Uint8List bytes
XFile xFile = XFile('Your image path');
Code? resultFromXFile = await zx.readBarcodeImagePath(xFile);

String path = 'Your local image path';
Code? resultFromPath = await zx.readBarcodeImagePathString(path);

String url = 'Your remote image url';
Code? resultFromUrl = await zx.readBarcodeImageUrl(url);

Uint8List bytes = Uint8List.fromList(yourImageBytes);
Code? resultFromBytes = await zx.readBarcode(bytes);

To create barcode

import 'package:flutter_zxing/flutter_zxing.dart';
import 'dart:typed_data';
import 'package:image/image.dart' as imglib;

// Use WriterWidget to quickly create barcode
@override
Widget build(BuildContext context) {
  return Scaffold(
    body: WriterWidget(
      onSuccess: (result, bytes) {
        // Do something with the result
      },
      onError: (error) {
        // Do something with the error
      },
    ),
  );
}

// Or use FlutterZxing to create barcode directly
final Encode result = zx.encodeBarcode(
    contents: 'Text to encode',
    params: EncodeParams(
        format: Format.QRCode,
        width: 120,
        height: 120,
        margin: 10,
        eccLevel: EccLevel.low,
    ),
);
if (result.isValid) {
    final img = imglib.Image.fromBytes(width, height, result.data);
    final encodedBytes = Uint8List.fromList(imglib.encodeJpg(img));
    // use encodedBytes as you wish
}

License

MIT License. See LICENSE.