flutter_thermal_printer
Plugin for Flutter to print on thermal printers via ESC/POS commands.
2.2.1
6.9K downloads/mo
#3421 most downloaded on pub.dev
SunilDevX/flutter_thermal_printer
What this package is like to depend on
Last release 3 months ago
19 May 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 35 of 36 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
36 releases · first in 2024
6 releases in the last 12 months
see the full history below
Release timeline
36 releases · Jan 2024 to May 2026Releases
latest 36-
2.2.119 May 2026Release notes
Open source →- Added Swift Package Manager support for iOS and macOS, so Flutter apps can use the plugin through the newer Apple package flow.
- Kept CocoaPods support in place for projects that have not moved fully to Swift Package Manager yet.
- Moved the iOS and macOS Swift sources into the package layout expected by Swift Package Manager.
- Updated the iOS minimum version to 13.1 to match the current
universal_blerequirement. - Updated dependency versions, including
universal_ble,image, andwin32. - Fixed the Windows raw-printing helpers so they compile cleanly with the latest
win32API.
-
2.0.117 Feb 2026Release notes
Open source →- Fixed BLE discovery to also include system-connected devices using
getSystemDevices(). - Fixed BLE reconnect behavior so connection state updates correctly when reconnecting from system Bluetooth settings.
- Added BLE connection-state synchronization and listener management to keep
devicesStreamin sync after disconnect/reconnect cycles. - Updated BLE scan initialization to honor Android fine-location permission settings through platform scan config.
- Fixed BLE discovery to also include system-connected devices using
-
2.0.019 Dec 2025Release notes
Open source →-
Major Refactoring & Code Quality Improvements
- Fixed all linting and static analysis issues across the project.
- Improved null safety and type safety in
PrinterandPrinterManager. - Refactored
Printerclass to correctly handle name overrides and data sanitization. - Fixed Windows stub implementation for better cross-platform compatibility.
-
Documentation
- Added comprehensive DartDoc comments for all public methods in
FlutterThermalPrinterandPrinterManager. - Documented all parameters including
chunkSize,connectionStabilizationDelay, and others.
- Added comprehensive DartDoc comments for all public methods in
-
Testing
- Fixed and updated unit tests to ensure reliability Thanks to
@LosDanieloss. - Verified behavior of
Printerclass serialization and initialization.
- Fixed and updated unit tests to ensure reliability Thanks to
-
-
1.2.426 Sep 2025 -
1.2.311 Sep 2025Release notes
Open source →- Added Full Support for USB on Macos
- Changed Flutter_blue_plus to universal_ble for better support of BLE and Classic Devices
-
1.2.3+117 Sep 2025 -
1.2.205 Aug 2025Release notes
Open source →-
Enhanced Memory Management
- Proper stream lifecycle management with automatic cleanup
- Improved resource disposal in disconnect operations
- Optimized singleton pattern for thread safety
- Better garbage collection patterns
-
Image Processing Improvements
- Dynamic chunked image processing for better memory efficiency
- Improved image validation with comprehensive error handling
- Optimized image resizing algorithms
- Better support for varying image dimensions
-
Network Printer Enhancements
- Automatic connection validation and reconnection
- Improved socket error handling with specific exception types
- Better connection state management
- Enhanced timeout handling
-
Code Architecture Improvements
- Immutable Printer model with validation methods
- Separated concerns into focused, testable methods
- Enhanced error handling with meaningful messages
- Comprehensive documentation and type safety
-
Platform-Specific Optimizations
- Windows: Enhanced BLE initialization with proper error handling
- Android/iOS: Optimized BLE scanning with better subscription management
- All Platforms: Improved USB printer detection and management
-
New Features
copyWith()method for immutable Printer updatesuniqueIdproperty for better printer identificationhasValidConnectionDatavalidation method- Enhanced connection type validation
- Comprehensive toString() and equality implementations
-
Breaking Changes
- Printer class fields are now final (immutable)
- Use
copyWith()for printer updates instead of direct field assignment - Some internal method signatures have changed for better error handling
-
Developer Experience
- Added OPTIMIZATION_GUIDE.md with detailed optimization explanations
- Enhanced analysis_options.yaml with strict linting rules
- Improved error messages for better debugging
- Better type safety throughout the codebase
-
-
1.2.110 Apr 2025Release notes
Open source →- Fixed the issue of Flutter Blue plus for windows as it not supported for windows
- Github repo for issues is now changed
-
1.2.1+109 May 2025Nothing published for this version
-
1.2.006 Mar 2025Release notes
Open source →- Fixed BLE turn on exception for ios and macos by
@eduardohr-muniz - Reduced time to print image on ble devices by
@eduardohr-muniz
- Fixed BLE turn on exception for ios and macos by
-
1.1.006 Feb 2025Release notes
Open source →- Added Improvments for windows Printing Thanks to
@eduardohr-muniz - Updated Dependents Packages
- Added Improvments for windows Printing Thanks to
-
1.0.130 Dec 2024 -
1.0.030 Dec 2024 -
0.0.2017 Dec 2024 -
0.0.1910 Dec 2024 -
0.0.19+110 Dec 2024 -
0.0.19+213 Dec 2024 -
0.0.1803 Dec 2024Release notes
Open source →- Added
turnOnBluetoothfunction - Added
isBleTurnedOnStreamStream of bluetooth is turned on or off - Added
isBleTurnedOnfunction - Added
printWidgetfunction for printing any flutter widget - Updated USB Connection for Android
- Updated BLE for All Platforms
- Added
-
0.0.18+103 Dec 2024 -
0.0.1717 Oct 2024 -
0.0.1612 Sep 2024Release notes
Open source →- Bumped packages dependent on like flutter_blue_plus,win32,flutter_utils_plus
-
0.0.1522 Jul 2024Release notes
Open source →- Added new extension for Printer of connectionsState
- Now you can get system connected devices on macos
-
0.0.1419 Jul 2024 -
0.0.1308 Jul 2024 -
0.0.1210 May 2024 -
0.0.1110 May 2024 -
0.0.1010 May 2024 -
0.0.903 May 2024 -
0.0.823 Apr 2024 -
0.0.718 Mar 2024 -
0.0.618 Mar 2024Release notes
Open source →- Added USB Printing for Windows Devices
- Read Take Care Of part at below in Readme for More.
-
0.0.522 Feb 2024 -
0.0.421 Feb 2024 -
0.0.320 Feb 2024 -
0.0.209 Feb 2024Release notes
Open source →- Added Support for Windows Bluetooth
- Added Start and Stop Scanning for BLE devices
- Added Connect and Disconnect Printer
- Added Printer Model Class
- Added
longdatato print data for long text
-
0.0.117 Jan 2024