Skip to content
pubscout

unified_esc_pos_printer

3.4.0, released 4 months ago by elriztechnology.com

Unified ESC/POS thermal printer package for USB, Bluetooth, BLE, and Network connections.

WASM-ready
$ flutter pub add unified_esc_pos_printer
Source repository

What it does

Provides a single PrinterManager API to discover printers and print tickets via USB, Bluetooth Classic, BLE, and Network connections. It supports full ESC/POS command generation including text formatting, images, barcodes, QR codes, tables, and multilingual text rasterization.

AI-written summary of version 3.4.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to print receipts or tickets from Flutter to thermal printers using USB, Bluetooth, BLE, or Network.
  • You require multi-language support (such as CJK or Arabic) rendered as images on thermal printers.

Skip it when

  • You are building a web-based app, as web browsers lack raw TCP, SPP, or USB access required by this package.
  • You need to print standard PDF documents instead of raw ESC/POS text and receipt commands.

Strengths

  • Supports multiple connection types (Network, Bluetooth Classic, BLE, USB) through a single unified API.
  • Built-in device discovery and capability profiles for over 200 printer models.
  • Supports multilingual text rasterization using Flutter's text engine.

Weaknesses

  • Not functional on the web platform due to browser hardware limitations.
  • Requires platform-specific permission setups on Android and iOS.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
4

Requires adding network, bluetooth, or USB permissions and features to Android's AndroidManifest.xml and usage descriptions to iOS's Info.plist depending on the connection types used.

import 'package:unified_esc_pos_printer/unified_esc_pos_printer.dart';

final manager = PrinterManager();
final printers = await manager.scanPrinters(timeout: const Duration(seconds: 5));
await manager.connect(printers.first);
final ticket = await Ticket.create(PaperSize.mm80);
ticket.text('Hello, Printer!');
ticket.cut();
await manager.printTicket(ticket);
await manager.disconnect();
manager.dispose();

Alternatives

Packages that do the same job and could replace unified_esc_pos_printer.

Works with

Packages commonly used together with unified_esc_pos_printer: ones it builds on, ones built on it, and its own family.