NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #277 most downloaded on pub.dev
A universal Flutter barcode and QR code scanner using CameraX/ML Kit for Android, AVFoundation/Apple Vision for iOS & macOS, and ZXing for web.
Latest stable
7.5.0
Last release 11 days ago
03 Nov 2026
Release timing varies
gaps range from 9 days to 5 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
5 years old
89 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Added the option to switch between bundled and unbundled MLKit for Android. (thanks @woolfred !)
New Features:
Bugs fixed:
Improvements:
NOTE: From this version onwards, mobile_scanner requires Android projects to have a compileSdk of 34 (Android 14) or higher
New Features:
Bugs fixed:
Improvements:
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Change MediaQuery.sizeOf(context) to of(context).size for backwards compatibility
Change MediaQuery.sizeOf(context) to of(context).size for backwards compatibility
This PR adds an option to add an overlay to the scanner which is only visible when the scanner has started. (thanks @svenopdehipt !)
New Features:
Improvements:
fix a bug in the static interop binding of PhotoCapabilities (thanks @navaronbracke !)
[Web] add the corners from the ZXing result to the barcode on web (thanks @navaronbracke !)
update the example app web entrypoint to the latest template by running flutter create . --platforms=web (thanks @navaronbracke !)
add better handling for the case where scanning barcodes is unsupported (for example a desktop running the browser sample) (thanks @navaronbracke !)
[Web] fix the permission denied handling on the web, by using the NotAllowedError error message as defined by MDN (thanks @navaronbracke !)
add app bars with back buttons to the example app (so that you can go back easily) (thanks @navaronbracke !)
[iOS] Implements a fix from issue iOS After first QR Code Scan, When Scanning again, First Image stays on Camera buffer (thanks @FlockiiX !)
By dynamically adjusting the positioning and scaling of the scan window relative to the texture, the package ensures optimal coverage and alignment for scanning targets. (thanks @sdkysfzai !)
In the original package, If there are multiple barcode/qrcodes in the screen, the scan would randomly pick up any barcode/qrcode that shows in the screen, This upgrade fixes it and picks on the qrcode/barcode that is in the center of the camera. (thanks @sdkysfzai !)
In the original package if you changed the camera size, it would still pick scans even if the barcode are not shown in the screen, This issue is also fixed in the upgraded packaged. (thanks @sdkysfzai !)
[iOS] This removes a threading warning (and potentially jank). (thanks @ened !)
[Android] fix(ScanImage): fix android image result is not correct format and orientation (thanks @phanbaohuy96 !)
[iOS] Respect detectionTimeout on iOS devices, instead of arbitrarily waiting 10 frames (thanks @jorgenpt !)
[iOS] Don't start a second scan until the first one is done, to keep memory usage more fixed if the device is slow (thanks @jorgenpt !)
[Android] This PR ensure that the camera is not stopped in the callback. (thanks @g123k !)
[macOS] Fix some macOS build errors (thanks @svenopdehipt !)
[Android] Fixed an issue which caused the App Lifecycle States to not work correctly on Android. (thanks @androi7 !)
Fixed bug where onDetect method was being called multiple times
Bugs fixed:
namespace attribute to the build.gradle.Improvements:
[iOS] Updated GoogleMLKit/BarcodeScanning to 4.0.0
Improvements:
Bugs fixed:
[iOS] Fixed a bug that caused a crash when switching from camera.
Bugs fixed:
[iOS] No longer automatically focus on faces.
Improvements:
This big release contains all improvements from the beta releases. In addition to that, this release contains:
This big release contains all improvements from the beta releases. In addition to that, this release contains:
Improvements:
Fixes a permission bug on Android where denying the permission would cause an infinite loop of permission requests.
Fixes:
Features:
errorBuilder to the MobileScanner widget that can be used to customize the error state of the preview. (Thanks @navaronbracke !)The onPermissionSet argument of the MobileScannerController is now deprecated.
Special thanks to p-mazhnik, navaronbracke and WenheLI for the code improvements and new features!
Deprecated:
onStart method has been renamed to onScannerStarted.onPermissionSet argument of the MobileScannerController is now deprecated.Breaking changes:
MobileScannerException now uses an errorCode instead of a message.MobileScannerException now contains additional details from the original error.MobileScannerController.start() to throw MobileScannerExceptions
with consistent error codes, rather than string messages.
To handle permission errors, consider catching the result of MobileScannerController.start().autoResume attribute has been removed from the MobileScanner widget.
The controller already automatically resumes, so it had no effect.MobileScannerCallback and MobileScannerArgumentsCallback typedef.jsqr library with zxing-js for full barcode support.Improvements:
called stop while already stopped messages.Features:
scanWindow to the MobileScanner() widget.placeholderBuilder function to the MobileScanner widget to customize the preview placeholder.autoStart parameter to MobileScannerController(). If set to false, controller won't start automatically.hasTorch function on MobileScannerController(). After starting the controller, you can check if the device has a torch.torchEnabled parameter from MobileScannerController() on iOSWebBarcodeReaderBase class and changing barCodeReader property in MobileScannerWebPluginFixes:
MobileScannerController.stop() throwing when already stopped.MobileScannerController.toggleTorch() throwing if the device has no torch.
Now it does nothing if the torch is not available.MobileScanner would keep listening to the barcode events.MobileScanner preview depending on all attributes of MediaQueryData.
Now it only depends on its layout constraints.onPermissionSet in MobileScanner widget is deprecated and will be removed. Use the onPermissionSet onPermissionSet callback in MobileScannerController…
Breaking changes:
Features:
Other improvements:
[Android] SDK updated to SDK 33.
Breaking changes:
Features:
Other changes:
Upgraded GoogleMLKit/BarcodeScanning pod on iOS from 2.6.0 to 3.2.0. Migrated to stable version of androidx.camera for Android.
Upgraded GoogleMLKit/BarcodeScanning pod on iOS from 2.6.0 to 3.2.0. Migrated to stable version of androidx.camera for Android.
Please checkout version 3.0.0-beta.2 for the latest features.
Breaking changes: This version is only compatible with flutter 3.0.0 and later.
Breaking changes: This version is only compatible with flutter 3.0.0 and later.
This version uses the MLKit play-services model on Android in order to save space. With the example app, this version reduces the release version from
This version uses the MLKit play-services model on Android in order to save space. With the example app, this version reduces the release version from 14.9MB to 7MB. More information: https://developers.google.com/ml-kit/vision/barcode-scanning/android
This version is the last version that will run on Flutter 2.x
This version is the last version that will run on Flutter 2.x
Bugfixes:
This version uses the MLKit play-services model on Android in order to save space. With the example app, this version reduces the release version from
This version uses the MLKit play-services model on Android in order to save space. With the example app, this version reduces the release version from 14.9MB to 7MB. More information: https://developers.google.com/ml-kit/vision/barcode-scanning/android
Update camera dependency for Android.
Bugfixes:
This version uses the MLKit play-services model on Android in order to save space. With the example app, this version reduces the release version from
This version uses the MLKit play-services model on Android in order to save space. With the example app, this version reduces the release version from 14.9MB to 7MB. More information: https://developers.google.com/ml-kit/vision/barcode-scanning/android
Fix for 'stream already listened to' exception.
Bugfixes:
BREAKING CHANGES: This version adds a new allowDuplicates option which now defaults to FALSE. this means that it will only call onDetect once after a…
BREAKING CHANGES: This version adds a new allowDuplicates option which now defaults to FALSE. this means that it will only call onDetect once after a scan. If you still want duplicates, you can set allowDuplicates to true. This also means that you don't have to check for duplicates yourself anymore.
New features:
Bugfixes:
You can provide a path to controller.analyzeImage(path) in order to scan a local photo from the gallery! Check out the example app to see how you can
You can provide a path to controller.analyzeImage(path) in order to scan a local photo from the gallery! Check out the example app to see how you can use the image_picker plugin to retrieve a photo from the gallery. Please keep in mind that this feature is only supported on Android and iOS.
Another feature that has been added is a format selector! Just keep in mind that iOS for now only supports 1 selected barcode.
Fixed crash after asking permission. #29
MobileScannerArguments is now exported. #7
mobile_scanner is now compatible with sdk >= 2.12 and flutter >= 2.2.0
mobile_scanner is now compatible with sdk >= 2.12 and flutter >= 2.2.0
We now have MacOS support using Apple's Vision framework! Keep in mind that for now, only the raw value of the barcode object is supported.
We now have MacOS support using Apple's Vision framework! Keep in mind that for now, only the raw value of the barcode object is supported.
Bugfixes:
* Added some API docs and README * Updated the example app
You can select the camera you want to use
Fixed on iOS:
Initial release! Things working on Android:
Initial release! Things working on Android:
Things working on iOS:
One column per quarter.