Search packages, repositories and app categories

Package detailsv1.0.3

flutter_esc_pos_network

The library allows printing receipts using ESC/POS commands using thermal Wi-Fi/Ethernet printer.

AndroidiOSmacOSWindowsLinux
30-day downloads
2.8K
Likes
30
Pub points
130

Install package

flutter pub add flutter_esc_pos_network

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package enabling receipt printing via ESC/POS commands on thermal printers connected over Wi-Fi or Ethernet. It facilitates communication with networked printers using standard ESC/POS protocols, making it ideal for point-of-sale systems and retail applications. The library supports multiple platforms including Android, iOS, macOS, Windows, and Linux, ensuring cross-platform compatibility. Developers can send formatted text, barcodes, and images to printers directly from their Flutter apps.

Use cases

  • Point-of-sale systems
  • Retail receipt printing
  • Restaurant order printing
  • Inventory management
  • Event ticket printing

Key features

  • Wi-Fi and Ethernet printer support
  • ESC/POS command compatibility
  • Cross-platform functionality
  • Text, barcode, and image printing
  • Simple integration with Flutter apps

Suitable for

  • Retail developers
  • POS application creators
  • Mobile app developers needing printing
  • Businesses with networked thermal printers
  • IoT-enabled kiosk solutions

Considerations

  • Requires compatible ESC/POS printer
  • Network configuration needed
  • Printer IP address must be known
  • Limited to network-connected devices
  • No built-in printer discovery feature

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

flutter_esc_pos_network

The library allows to print receipts using an ESC/POS thermal WiFi/Ethernet printer. For Bluetooth printers, use esc_pos_bluetooth library.

It can be used in Flutter or pure Dart projects. For Flutter projects, both Android, iOS, windows, Linux and MacOS are supported.

To scan for printers in your network, consider using ping_discover_network package. Note that most of the ESC/POS printers by default listen on port 9100.

TODO (PRs are welcomed!)

  • Print QR Codes using the GS ( k command (printing QR code from an image already supported)
  • PDF-417 Barcodes using the GS ( k command
  • Line spacing using the ESC 3 <n> command

How to Help

  • Test your printer and add it in the table: Wifi/Network printer or Bluetooth printer
  • Test and report bugs
  • Share your ideas about what could be improved (code optimization, new features...)
  • PRs are welcomed!

Tested Printers

Here are some printers tested with this library. Please add the models you have tested to maintain and improve this library and help others to choose the right printer.

Generate a Receipt

Simple Receipt with Styles:
void testReceipt(NetworkPrinter printer) {
  printer.text(
        'Regular: aA bB cC dD eE fF gG hH iI jJ kK lL mM nN oO pP qQ rR sS tT uU vV wW xX yY zZ');
  printer.text('Special 1: àÀ èÈ éÉ ûÛ üÜ çÇ ôÔ',
      styles: PosStyles(codeTable: 'CP1252'));
  printer.text('Special 2: blåbærgrød',
      styles: PosStyles(codeTable: 'CP1252'));

  printer.text('Bold text', styles: PosStyles(bold: true));
  printer.text('Reverse text', styles: PosStyles(reverse: true));
  printer.text('Underlined text',
      styles: PosStyles(underline: true), linesAfter: 1);
  printer.text('Align left', styles: PosStyles(align: PosAlign.left));
  printer.text('Align center', styles: PosStyles(align: PosAlign.center));
  printer.text('Align right',
      styles: PosStyles(align: PosAlign.right), linesAfter: 1);

  printer.text('Text size 200%',
      styles: PosStyles(
        height: PosTextSize.size2,
        width: PosTextSize.size2,
      ));

  printer.feed(2);
  printer.cut();
}

You can find more examples here: flutter_esc_pos_utils.

Print a Receipt

import 'package:flutter_esc_pos_network/flutter_esc_pos_network.dart';
final printer = PrinterNetworkManager('192.168.1.100');
    PosPrintResult connect = await printer.connect();
    if (connect == PosPrintResult.success) {
      PosPrintResult printing = await printer.printTicket(ticket);

      print(printing.msg);
      printer.disconnect();
    }
  }

For a complete example, check example/example.dart

Categories

Dependencies

Dependency list 1 items

Source repository

Projects using this package

No data available yet.