Aus öffentlichen Paketdaten erstellte Orientierung.
Ein Flutter-Plugin zur Druckausgabe auf thermische Drucker mittels ESC/POS-Befehle. Es unterstützt Android, iOS, macOS und Windows und ermöglicht Entwicklern, formatierten Text, Barcodes und Bilder direkt an kompatible thermische Drucker zu senden. Das Paket bietet eine einfache API zum Ausgeben von ESC/POS-Befehlen und ist ideal für die Rechnungsdruckerei in Einzelhandel, Gastronomie und Verkaufsstellen. Es integriert sich nahtlos in Flutter-Anwendungen und nutzt native Plattformfunktionen über Plattformkanäle.
Anwendungsfälle
Belegdruck in POS-Systemen
Etikettendruck für Inventar
Erzeugung von Ereignistickets
Bestellbestätigungsdruk
Mobiles Kiosk-Drucken
Hauptmerkmale
Unterstützt ESC/POS-Befehlssatz
Plattformübergreifende Kompatibilität
Text-, Barcode- und Bilddruck
Einfache API für ESC/POS-Befehle
Native Integration über Plattformkanäle
Geeignet für
Einzelhandels- und Restaurant-POS-Apps
Mobile Drucklösungen
Inventarverwaltungstools
Veranstaltungs- und Ticket-Apps
Kiosk- und Selbstbedienungsanwendungen
Hinweise
Erfordert kompatible Thermoprinter
ESC/POS-Befehlswissen erforderlich für erweiterte Formatierung
Beschränkt auf Geräte, die Bluetooth- oder USB-Druck unterstützen
Plattformspezifische Einrichtung kann erforderlich sein
Die Verfügbarkeit von Druckertreibern variiert je nach Betriebssystem
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
flutter_thermal_printer
Buy Me A Coffee
If you find this project helpful and want to support its development, you can buy me a coffee:
Getting Started
This plugin is used to print data on thermal printers with ease across multiple platforms.
🎉 New Feature: USB Printing Services
✨ Exciting Update! We now support USB printing services across multiple platforms! Connect your thermal printers directly via USB for faster, more reliable printing without the need for wireless connections.
Supported Platforms for USB:
🤖 Android - Full USB support
🖥️ Windows - Complete USB integration
🍎 macOS - Native USB connectivity
Experience enhanced printing performance with direct USB connections!
Currently Supported
Service
Android
iOS
macOS
Windows
Bluetooth
✅
✅
✅
✅
USB
✅
✅
✅
BLE
✅
✅
✅
✅
WiFi
✅
✅
✅
✅
final _flutterThermalPrinterPlugin = FlutterThermalPrinter.instance;
// Enum ConnectionTypeenumConnectionType {
BLE,
USB,
NETWORK,
}
// Additional Functions// Recommended Function for getting printersgetPrinters(
refreshDuration: Duration,
connectionTypes: List<ConnectionType>,
) {
// Supports WINDOWS, ANDROID , Macos for USB// MAC, IOS, ANDROID, WINDOWS for BLUETOOTH.
}
// Refer to Example for Complete code
macOS printer connection types
Installed macOS print queues are classified using their native device URI:
usb:// is USB; dnssd://, ipp://, ipps://, http://, https://,
socket://, lpd://, and smb:// are NETWORK. Unknown or missing schemes
have a null connectionType and display as UNKNOWN.
The default scan includes all three types. An explicit USB-only scan excludes
network queues; a NETWORK-only scan returns installed network queues on macOS.
Unknown system queues appear when both USB and NETWORK are requested. This does
not discover uninstalled LAN printers or identify thermal/ESC/POS compatibility.
Printer.deviceUri preserves the destination URI and Printer.queueName holds
the macOS queue ID. System queues continue printing through the native macOS
backend, including printWidget; a Bonjour/IPPS URI is not passed to the raw
TCP network printer API. The queue's isConnected value still indicates that it
is installed, not that the physical printer is reachable. Other platforms retain
their existing discovery mechanisms.
Easily capture and print widgets as images using the printWidget method.
Image Cropping for Long Prints
Handles long data by cropping images and printing them in chunks to ensure seamless printing on devices with limited buffer capacity.
Connection Type Validation
Ensures ConnectionType compatibility and alerts when unsupported combinations are used.
BLE State Monitoring
Provides real-time monitoring for Bluetooth states, ensuring proactive error handling and reconnections.
BLE Connection Configuration
Customize BLE connection behavior to optimize for different printer models:
// Global configuration (applies to all BLE connections)FlutterThermalPrinter.instance.bleConfig =
BleConfig(connectionStabilizationDelay: Duration(seconds: 3));
// Per-connection override for specific devicesawaitFlutterThermalPrinter.instance.connect(
printer,
connectionStabilizationDelay: Duration(seconds: 2),
);
// Default behavior (10 seconds) - no configuration neededawaitFlutterThermalPrinter.instance.connect(printer);
Configuration
Use Case
Global config
Set once for consistent behavior across all connections
Per-call override
Fine-tune for specific printer models that connect faster/slower
Default (10s)
Backwards compatible, works with most printers
Notes and Recommendations
Windows & MacOS Users: Make sure you have the XPrinter driver installed on Windows for printer compatibility.
Download the driver from XPrinter Driver.
Cross-Platform Usage: Ensure Bluetooth permissions and configurations are set correctly for Android and iOS.
Contributing Guidelines
We welcome contributions to enhance the plugin's functionality!
To contribute, please fork the repository, make changes, and submit a pull request.
For bug reports or feature requests, feel free to open an issue.
Contributors
Feel free to contribute to this project and help make it better for everyone!