Search packages, repositories and app categories

Package detailsv4.2.0

sunmi_printer_plus

Support V2 Pro Sunmi Label Version and Null safety. With this package you can connect with Sunmi printers, print text, image, qrcode, barcodes and a custom Esc/Pos if you like.

Android
30-day downloads
27.5K
Likes
156
Pub points
160

Install package

flutter pub add sunmi_printer_plus

Package Overview

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

The sunmi_printer_plus package enables seamless integration with Sunmi V2 Pro label printers on Android, supporting null safety and custom Esc/Pos commands. It allows developers to print text, images, QR codes, and barcodes directly from Flutter apps. Designed for reliability and ease of use, it provides a straightforward API for sending print jobs to Sunmi hardware, making it ideal for retail, logistics, and point-of-sale applications requiring label or receipt printing.

Use cases

  • Retail receipt printing
  • Label printing for logistics
  • Point-of-sale systems
  • Inventory management
  • Custom Esc/Pos command execution

Key features

  • Supports Sunmi V2 Pro label printers
  • Null safety compliant
  • Print text, images, QR codes, barcodes
  • Custom Esc/Pos command support
  • Android-only platform compatibility

Suitable for

  • Flutter developers targeting Sunmi printers
  • Business apps needing label printing
  • POS system integrations
  • Mobile inventory solutions

Considerations

  • Android only
  • Requires compatible Sunmi hardware
  • Limited to Esc/Pos-based printing
  • No iOS or desktop support
  • Needs proper device permissions

Original README

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

sunmi_printer_plus

This is a fork from sunmi_printer , but i implemented a lot of other features described below

Pub Monthly Downloads Pub Points Pub Likes GitHub Issues or Pull Requests GitHub contributors

Important:

THIS PACKAGE WILL WORK ONLY IN ANDROID!

Support Sunmi and Null Safety. I build this flutter plugin based on this: Official Sunmi Inner Printer Doc. But not all method from doc was included in this package, beacuse i don't have equipment. If you have and can help me, just contact me on github!

Installation

flutter pub add sunmi_printer_plus

What this package do

  • [x] Print in label mode (when avaliable!)
  • [x] Write some text (with style or not!)
  • [x] Change font size
  • [x] Jump (n) lines
  • [x] Draw a divisor line
  • [x] Bold mode on/off
  • [x] Print all types of Barcodes (see enum below)
  • [x] Print Qrcodes with custom width and error-level
  • [x] Print image from asset or from web (example show how to print both)
  • [x] Print rows like recepit with custom width and alignment
  • [x] Able to combine with some esc/pos code that you already have!
  • [x] Cut paper - Dedicated method just to cut the line
  • [x] Printer serial no - Get the serial number of the printer
  • [x] Printer version - Get the printer's version
  • [x] Printer paper size - Get the paper size ( 0: 80mm 1: 58mm)
  • [x] LCD Print a image ytyng
  • [x] LCD Print a string , multi lines as double lines Thanks to ytyng
  • [x] Open de cash drawer Thanks to ZheruiL
  • [x] Check if the cash drawer is connected or not
  • [x] Get how many times the cash drawer was oppened

Tested Devices

Sunmi V2 Pro 
Sunmi T2 mini
Sunmi V2S

You can also combine this package with the package esc_pos_utils

With this package you can create a custom escpos and than you don't need to use any other command. This is good if you already have a code that another printers use, and u can reuse this code as well

#Just see the example folder!

// import packages
import 'package:sunmi_printer_plus/sunmi_printer_plus.dart';


// all method from sunmi printer need to async await
await SunmiPrinter.bindingPrinter(); // must bind the printer first. for more exmaple.. pls refer to example tab.

Example code when use for transaction printing

  await SunmiPrinter.startTransactionPrint(true);

  await SunmiPrinter.setAlignment(SunmiPrintAlign.RIGHT); // Right align
  await SunmiPrinter.printText('Align right');

  await SunmiPrinter.setAlignment(SunmiPrintAlign.LEFT);// Left align
  await SunmiPrinter.printText('Align left');

  await SunmiPrinter.setAlignment(SunmiPrintAlign.CENTER);// Center align
  await SunmiPrinter.printText('Align center');

  await SunmiPrinter.lineWrap(2); // Jump 2 lines

  await SunmiPrinter.setFontSize(SunmiFontSize.XL); // Set font to very large
  await SunmiPrinter.printText('Very Large font!');
  await SunmiPrinter.resetFontSize(); // Reset font to medium size

  await SunmiPrinter.setCustomFontSize(12); // SET CUSTOM FONT 12
  await SunmiPrinter.printText('Custom font size!!!');
  await SunmiPrinter.resetFontSize(); // Reset font to medium size

  await SunmiPrinter.printQRCode('https://github.com/brasizza/sunmi_printer'); // PRINT A QRCODE
  await SunmiPrinter.submitTransactionPrint(); // SUBMIT and cut paper
  await SunmiPrinter.exitTransactionPrint(true); // Close the transaction

Example code for LCD functions @ytyng

 await SunmiPrinter.lcdInitialize(); //Initialize the LCD 
 await SunmiPrinter.lcdWakeup(); //Turn the LCD ON
 await SunmiPrinter.lcdSleep(); //Turn the LCD OFF
 await SunmiPrinter.lcdClear(); //Clear LCD screen
 await SunmiPrinter.lcdString('Hello'); //Write a simple line 
 await SunmiPrinter.lcdString('Hello'); //Write a simple line 
 await SunmiPrinter.lcdDoubleString('Hello', 'World'); //Write two lines

 Uint8List byte = await readFileBytes('assets/images/128x40.png');
 await SunmiPrinter.lcdImage(byte); // Put an image in LCD
 await SunmiPrinter.lcdFillString('abcDEFgj0123\$&=+', size: 16, fill: true); // Print a string and fill with zeros until the size is reached
 await SunmiPrinter.lcdMultiString([  'Welcome to flutter.',  'Align 2.',], [  1,  2,]); // Write multiple lines with alignent

Example to open the cashier @ZheruiL

  bool await SunmiPrinter.drawerStatus(); //check if the cash drawer is connect or disconnect

  await SunmiPrinter.openDrawer(); //open de cash drawer

  int await SunmiPrinter.drawerTimesOpen(); //How many times de cash drawer was oppened

List of enum printer mode
enum PrinterMode {
  NORMAL_MODE,
  BLACK_LABEL_MODE, 
  LABEL_MODE
}
List of enum Alignments
enum SunmiPrintAlign {
  LEFT,
  CENTER,
  RIGHT,
}
List of enum Qrcode levels
enum SunmiQrcodeLevel {
  LEVEL_L,
  LEVEL_M,
  LEVEL_Q,
  LEVEL_H,
}
List of enum Barcode types
enum SunmiBarcodeType {
  UPCA,
  UPCE,
  JAN13,
  JAN8,
  CODE39,
  ITF,
  CODABAR,
  CODE93,
  CODE128,
}
List of enum Text position in barcode
enum SunmiBarcodeTextPos {
  NO_TEXT,
  TEXT_ABOVE,
  TEXT_UNDER,
  BOTH,
}
List of enum Font sizes
enum SunmiFontSize {
  XS,
  SM,
  MD,
  LG,
  XL,
}

Categories

Dependencies

Dependency list 1 items

  • plugin_platform_interface^2.1.8

Source repository

Projects using this package