Package selection guidance compiled from public package information, community data, and project usage.
bluetooth_print_plus is a Flutter plugin enabling communication with Bluetooth thermal printers on Android and iOS. It supports multiple printer languages including TSPL/TSC, CPCL, and ESC/POS, making it suitable for printing receipts, labels, and tickets. The package provides a straightforward API for sending print commands and managing device connections. It also offers cross-platform compatibility with Web, macOS, and Linux, though functionality may be limited on non-mobile platforms. Ideal for retail, hospitality, and logistics applications requiring reliable mobile printing.
Use cases
Receipt printing in retail apps
Label printing for inventory systems
Ticket generation in event management
Mobile POS integration
On-the-go document printing
Key features
Supports TSPL/TSC, CPCL, and ESC/POS languages
Cross-platform support (Android, iOS, Web, macOS, Linux)
Simple API for sending print commands
Bluetooth device discovery and pairing
Real-time status monitoring
Suitable for
Retail and point-of-sale applications
Logistics and warehouse management
Event ticketing systems
Mobile printing solutions
Developers building cross-platform printing features
Considerations
Limited functionality on non-Android/iOS platforms
Requires proper permissions for Bluetooth access
Printer-specific command syntax may require testing
Not all printer models may fully support all languages
Web support may have restricted Bluetooth capabilities
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
Bluetooth Print Plus
Introduction
Bluetooth Print Plus is a Bluetooth plugin used to print thermal printers in Flutter, a new mobile SDK to help developers build bluetooth thermal printer apps for iOS and Android.
Important, important, important. First, you need to run the demo to confirm the printer command type ! ! !
now support tspl/tsc、cpcl、esc pos.
If this plugin is helpful to you, please give it a like, Thanks.
Buy Me A Coffee/请我喝杯咖啡
Plan
Version
plan
1.1.x
blue and tsc command, esc print image command
1.5.x
support cpcl command
2.x.x
improve esc command
3.x.x
support zpl command
Features
Android
iOS
Description
scan
:white_check_mark:
:white_check_mark:
Starts a scan for Bluetooth Low Energy devices.
connect
:white_check_mark:
:white_check_mark:
Establishes a connection to the device.
disconnect
:white_check_mark:
:white_check_mark:
Cancels an active or pending connection to the device.
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Need BLE permission</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>Need BLE permission</string>
error:'State restoration of CBCentralManager is only allowed for applications that have specified the "bluetooth-central" background mode'
info.plist add:
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Allow App use bluetooth?</string><key>NSBluetoothPeripheralUsageDescription</key><string>Allow App use bluetooth?</string><key>UIBackgroundModes</key><array><string>bluetooth-central</string><string>bluetooth-peripheral</string></array>