Skip to main content

flutter_ocr 1.0.0 copy "flutter_ocr: ^1.0.0" to clipboard
flutter_ocr: ^1.0.0 copied to clipboard

Modern, lightweight, zero-dependency Flutter OCR library for accurate offline text recognition, auto-deskew, entity extraction, and interactive UI overlays.

#1 Flutter OCR Library — 160/160 Pub Points • Zero Dependencies

pub.dev version pub points Zero Dependencies MIT License Supported by Humanize AI

flutter_ocr — Modern, Lightweight & Accurate Flutter OCR Library #

A modern, lightweight, zero-dependency Optical Character Recognition (OCR) library for Flutter and Dart. Built from the ground up with a 6-stage computer-vision pipeline, dynamic platform font calibration, structured entity extraction, and a suite of sleek, interactive Flutter UI widgets—with zero deprecated package:flutter/material.dart imports for seamless compatibility across Flutter 3.32 through Flutter 3.50+ and Dart 3.8–3.14+ (including WebAssembly).

Supported by Humanize AI


Live UI Showcase #

Real, unedited Flutter UI rendered directly by OcrInspector, OcrScannerOverlay, OcrResultViewer, and OcrEntityChips running live recognition via BuiltInOcrEngine:

Real Flutter OCR Studio UI — Live Laser Scan, Bounding Box Overlays, Entity Chips & 4 Modern Themes


Why flutter_ocr? #

Feature Details
Zero External Dependencies Depends strictly on flutter SDK (package:flutter/widgets.dart). Zero native binary bloat, zero platform-channel breakage, and zero package:flutter/material.dart deprecation warnings on Flutter 3.47–3.50+.
All 6 Platforms + Wasm Works identically on Android, iOS, Web (JS & Wasm), macOS, Windows, and Linux without dart:io or FFI locks.
6-Stage CV Pipeline Rec. 709 luminance, percentile contrast stretch, dark-mode auto-inversion, Otsu / O(W × H) integral-image Sauvola & Bradley-Roth binarization, automatic skew correction (±15°), and 8-connectivity Union-Find CCL.
Hybrid Multi-Cue Classifier Combines aspect-preserving Gaussian-smoothed ZNCC, positive cosine, 4×4 spatial zoning, 2×2×4 Sobel orientation gradients, Euler interior hole topology, vertical crossing profiles, and line-relative typography—plus automatic runtime platform font calibration.
Smart Entity Extraction Automatically extracts emails, URLs, dates, currency amounts, percentages, invoice IDs, phone numbers, card numbers, hashtags, and Key: Value pairs linked back to bounding boxes.
4 Modern Studio Themes Built-in Midnight, Aurora, Emerald, and Daylight themes with interactive bounding-box overlays (Blocks, Lines, Words, Characters), luminous scan beams, glassmorphic tooltips, and one-tap copy.
Pluggable Backend Use the offline BuiltInOcrEngine out of the box, or implement OcrEngine to plug in native/cloud backends while keeping the exact same models, entity parser, and UI widgets.

Installation #

Add flutter_ocr to your pubspec.yaml:

dependencies:
  flutter_ocr: ^1.0.0

Then run:

flutter pub get

Quick Start #

1. Recognize Text in 3 Lines #

import 'dart:typed_data';
import 'package:flutter_ocr/flutter_ocr.dart';

Future<void> scanDocument(Uint8List imageBytes) async {
  // Decodes PNG, JPEG, WebP, GIF, or BMP natively with zero dependencies.
  final OcrResult result = await OcrRecognizer.quickRead(imageBytes);

  print(result.text);
  print('Confidence: ${(result.confidence * 100).toStringAsFixed(1)}%');
  print('Latency: ${result.metrics.processingTime.inMilliseconds}ms');
}

2. Reusable Recognizer with Domain Presets #

final recognizer = OcrRecognizer(
  config: OcrConfig.receipt(), // Also: .document(), .screenshot(), .digitsOnly(), .fast()
);

final result = await recognizer.recognizeBytes(receiptBytes);

// Traverse full spatial hierarchy: blocks -> lines -> words -> characters
for (final block in result.blocks) {
  for (final line in block.lines) {
    print('${line.text}  @ ${line.boundingBox}');
  }
}

// Access automatically extracted structured entities
for (final entity in result.entities) {
  print('[${entity.type.name}] ${entity.label ?? ''} ${entity.value}');
}

// Export to Markdown, CSV, or pretty JSON
final markdown = result.toMarkdown();
final csv = result.toCsv();
final json = result.toJsonString(pretty: true);

recognizer.dispose();

3. Camera Streams, Raw Pixels & Widget Capture #

// Android camera YUV420 Y-plane (zero color-conversion overhead)
final camResult = await recognizer.recognizeYuv420(
  yPlane: cameraPlaneBytes,
  width: 1280,
  height: 720,
  bytesPerRow: 1280,
  config: OcrConfig.fast(),
);

// iOS/macOS BGRA8888 or standard RGBA8888 frames
final bgraResult = await recognizer.recognizeBgra(
  bgraBytes,
  width: 1280,
  height: 720,
);

// Capture & OCR any Flutter widget wrapped in a RepaintBoundary
final widgetResult = await recognizer.recognizeWidget(repaintBoundaryKey);

// Continuous stream processing
recognizer.recognizeStream(frameStream).listen((OcrResult frameResult) {
  // Update live HUD
});

4. Drop-In Modern UI Widgets (Zero material.dart Required!) #

All UI components rely exclusively on package:flutter/widgets.dart, avoiding deprecated Material imports and working cleanly in any Flutter app:

import 'package:flutter/widgets.dart';
import 'package:flutter_ocr/flutter_ocr.dart';

Widget buildOcrStudio(Uint8List imageBytes, OcrResult? result, bool scanning) {
  return OcrInspector(
    title: 'Invoice Scanner',
    theme: OcrThemeData.midnight(), // .aurora(), .emerald(), .daylight()
    isScanning: scanning,
    result: result,
    document: Image.memory(imageBytes, fit: BoxFit.contain),
    onEntityTap: (OcrEntity entity) {
      // Handle tapped email, amount, invoice ID, URL, or date
    },
  );
}

Or compose individual widgets directly:

  • OcrScannerOverlay — Animated viewfinder with luminous corner brackets, sweeping laser beam, live bounding boxes, and status pill.
  • OcrResultViewer — Pan/zoom interactive document canvas with clickable/hoverable bounding boxes (Blocks, Lines, Words, Characters) and floating confidence tooltips with one-tap copy.
  • OcrEntityChips — Category-coded interactive entity chips with crisp custom-painted vector icons.
  • OcrTheme / OcrThemeData — Inherited theme configuration with 4 studio presets (midnight, aurora, emerald, daylight).

5. Custom Pluggable Engine Backend #

class MyCloudOcrEngine implements OcrEngine {
  @override
  String get name => 'MyCloudOcrEngine';

  @override
  Future<OcrResult> recognize(
    OcrImage image, {
    OcrConfig config = const OcrConfig(),
  }) async {
    // Call your preferred native/cloud service and return an OcrResult.
    return OcrResult.empty(imageWidth: image.width, imageHeight: image.height);
  }

  @override
  void dispose() {}
}

final customRecognizer = OcrRecognizer(engine: MyCloudOcrEngine());

Processing Pipeline Architecture #

  1. Preprocessing (OcrPreprocessor & OcrDeskew)
    • Automatic resolution scaling, optional 3×3 median denoising, dark-mode polarity detection & inversion, 1st–99th percentile contrast stretching, automatic Otsu vs. O(W × H) integral-image Sauvola / Bradley-Roth binarization, isolated-pixel despeckling, and projection-profile coarse-to-fine deskewing (±15°).
  2. Segmentation (OcrCcl, OcrGlyphSplitter, OcrLayoutAnalyzer)
    • Two-pass Union-Find 8-connectivity CCL with page-border/rule filtering, within-line multi-part glyph reattachment (i, j, !, ?, :, ;, =, %, "), touching-glyph vertical-projection valley splitting, dominant-cluster baseline estimation, bimodal adaptive word spacing, and reading-order block grouping.
  3. Recognition & Calibration (OcrGlyphFeature, OcrVectorAtlas, OcrFontCalibrator, OcrGlyphClassifier)
    • Combines an analytical multi-weight & multi-style vector prototype atlas with optional live platform font calibration (dart:ui ParagraphBuilder, automatically skipping synthetic test fonts). Scores glyphs using 7 complementary visual, topological, and typographic cues.
  4. Post-Processing & Entities (OcrPostProcessor, OcrEntityExtractor)
    • Top-K safe contextual disambiguation (0/O, 1/l/I, 5/S, 8/B) followed by regex & layout-backed extraction of 10 structured semantic entity types.

Flutter 3.47–3.50+ / Dart 3.14+ Compatibility #

Starting in Flutter 3.47 (and enforced on pub.dev's Flutter 3.50 / Dart 3.14 analysis infrastructure), package:flutter/material.dart is deprecated in favor of package:material_ui/material_ui.dart.

This package never imports package:flutter/material.dart or package:flutter/cupertino.dart anywhere in lib/, example/, or test/. All widgets are built purely on package:flutter/widgets.dart and custom vector painters—giving you zero deprecation warnings, zero third-party design-system lock-in, and full compatibility across both legacy and latest Flutter SDKs.


Support #

This library is proudly supported by Humanize AI.


License #

Released under the MIT License. Copyright (c) 2026 Humanize AI Indonesia.

1
likes
160
points
--
downloads
screenshot

Documentation

API reference

Publisher

verified publisherhumanize.id

Modern, lightweight, zero-dependency Flutter OCR library for accurate offline text recognition, auto-deskew, entity extraction, and interactive UI overlays.

Repository (GitHub)
View/report issues

Topics

#ocr #text-recognition #document-scanner #image-processing #computer-vision

Funding

Consider supporting this project:

humanize.id

License

MIT (license)

Dependencies

flutter

More

Packages that depend on flutter_ocr