Skip to content
pubscout

bluetooth_print

4.3.0, released 4 years ago by an unverified publisher

Bluetooth plugin for printing text, images, QR codes and barcodes to thermal printers on iOS and Android.

WASM-readyQuiet but busy
$ flutter pub add bluetooth_print
Source repository

What it does

The package scans for BLE devices, connects to a selected printer, and sends ESC/POS commands to print receipts or labels. It supports printing plain text, images, QR codes and barcodes via a simple API.

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

Use it when

  • You need to print receipts or labels from a Flutter app using a Bluetooth thermal printer.
  • Cross‑platform (iOS/Android) support is required without writing native code.

Skip it when

  • You target web, desktop, or platforms without Bluetooth support.
  • You need advanced layout control like arbitrary x,y positioning not yet implemented.

Strengths

  • Works on both Android and iOS out of the box
  • Provides a stream of connection state for reactive UI
  • Supports text, image, QR code and barcode printing

Weaknesses

  • Limited to thermal printers; no support for arbitrary positioning yet
  • Requires manual permission configuration on each platform
  • No web or desktop support

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
Yes (build_runner)
Direct dependencies
2

Add BLUETOOTH, BLUETOOTH_SCAN, BLUETOOTH_CONNECT, BLUETOOTH_ADMIN and location permissions in AndroidManifest.xml; add NSBluetooth* and NSLocation* keys in iOS Info.plist.

import 'package:bluetooth_print/bluetooth_print.dart';

final bluetoothPrint = BluetoothPrint.instance;

// Scan for devices
bluetoothPrint.startScan(timeout: Duration(seconds: 4));

// Connect to a selected device
await bluetoothPrint.connect(selectedDevice);

// Print a simple receipt
await bluetoothPrint.printReceipt({}, [
  LineText(type: LineText.TYPE_TEXT, content: 'Hello', align: LineText.ALIGN_CENTER),
]);

Alternatives

Packages that do the same job and could replace bluetooth_print.

Works with

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