Skip to content
ZXing Barcode Scanning Library for MonoTouch, Mono for Android, and Windows Phone
Branch: master
Clone or download
Pull request Compare This branch is 10 commits ahead of Redth:master.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Art Make Android and iOS samples prettier Feb 8, 2016
Component-Forms Remove accidentally added duplicate key Mar 31, 2017
Samples GTK rendering support Jan 24, 2019
Source macOS: fix QRcode upside-down rendering Feb 25, 2019
Tests Added docs around a manual test plan Oct 30, 2017
UITests Standardize nuget refs Oct 24, 2017
tools build: pin Cake to version 0.26.1 as a workaround for Redth#772 Nov 1, 2018
.gitattributes Initial Commit Oct 10, 2012
.gitignore GTK rendering support Jan 24, 2019
.gitmodules Add submodule to fork of upstream Mar 31, 2017 Created separate changelog file Apr 18, 2016
ZXing.Net.Mobile.Forms.nuspec GTK rendering support Jan 24, 2019
ZXing.Net.Mobile.Forms.sln GTK rendering support Jan 24, 2019
ZXing.Net.Mobile.UITests.sln Updated more references to submodule Mar 31, 2017
ZXing.Net.Mobile.WP8.sln Fix up WP8 solutions Mar 31, 2017
ZXing.Net.Mobile.nuspec GTK rendering support Jan 24, 2019
ZXing.Net.Mobile.sln Still build iOS _libs_ on windows Mar 31, 2017
build.cake build.cake: make Default target redirect to "libs" Nov 1, 2018
build.ps1 Always download nuget latest version to tools Mar 14, 2018 add more echo statements Nov 1, 2018 GTK rendering support Jan 24, 2019 Added options for camera analysis intervals Mar 20, 2013 Added options for camera analysis intervals Mar 20, 2013


ZXing.Net.Xamarin Logo

ZXing.Net.Xamarin is a C#/.NET library based on the open source Barcode Library: ZXing (Zebra Crossing), using the ZXing.Net Port. It works with Xamarin.iOS, Xamarin.Android, Xamarin.Mac, GTK# and Windows Phone. The goal of ZXing.Net.Xamarin is to make scanning barcodes as effortless and painless as possible in your own applications. The new iOS7 AVCaptureSession barcode scanning is now also supported!

AzureDevOps CI status NuGet NuGet


The simplest example of using ZXing.Net.Xamarin looks something like this:

buttonScan.Click += (sender, e) => {

	#if __ANDROID__
	// Initialize the scanner first so it can track the current context
	MobileBarcodeScanner.Initialize (Application);
	var scanner = new ZXing.Mobile.MobileBarcodeScanner();

	var result = await scanner.Scan();

	if (result != null)
		Console.WriteLine("Scanned Barcode: " + result.Text);

Xamarin Forms

For Xamarin Forms there is a bit more setup needed. You will need to initialize the library on each platform in your platform specific app project.


On Android, in your main Activity's OnCreate (..) implementation, call:


ZXing.Net.Mobile for Xamarin.Forms also handles the new Android permission request model for you, but you will need to add the following override implementation to your main Activity as well:

public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Permission[] grantResults)
    global::ZXing.Net.Mobile.Android.PermissionsHandler.OnRequestPermissionsResult (requestCode, permissions, grantResults);           

The Camera permission should be automatically included for you in the AndroidManifest.xml however if you would like to use the Flashlight API you will still need to add the Flashlight permission yourself. You can do this by using the following assembly level attribute:

[assembly: UsesPermission (Android.Manifest.Permission.Flashlight)]

In your AppDelegate's FinishedLaunching (..) implementation, call:


In your MainClass's Main (..) implementation, call:


In your AppDelegate's DidFinishedLaunching (..) implementation, call:

Windows Phone

In your main Page's constructor, you should add:

Windows Universal UWP

In your main Page's constructor, you should add:


If you notice that finishing scanning or pressing the back button is causing your Page to jump back further than you'd like, or if you're having trouble updating the UI of a Page after scanning is completed, you may need to set NavigationCacheMode="Enabled" within your Page's XAML <Page ... /> element.


  • Xamarin.iOS
  • Xamarin.Mac (rendering only, not scanning)
  • Xamarin.Android (Including Google Glass)
  • GTK# (rendering only, not scanning)
  • Windows Phone 8
  • Simple API - Scan in as little as 2 lines of code!
  • Scanner as a View - UIView (iOS) / Fragment (Android) / Control (WP)

Android Versions

The component should work on Android 2.2 or higher. In Xamarin.Android there are 3 places in the project settings relating to Android version. YOU MUST set the Project Options -> Build -> General -> Target Framework to 2.3 or higher. If you still want to use 2.2, you can set the Project Options -> Build -> Android Application -> Minimum Android version to 2.2, but be sure to set the Target Android version in this section to 2.3 or higher.

Custom Overlays

By default, ZXing.Net.Mobile provides a very simple overlay for your barcode scanning interface. This overlay consists of a horizontal red line centered in the scanning 'window' and semi-transparent borders on the top and bottom of the non-scanning area. You also have the opportunity to customize the top and bottom text that appears in this overlay.

If you want to customize the overlay, you must create your own View for each platform. You can customize your overlay like this:

var scanner = new ZXing.Mobile.MobileBarcodeScanner();
scanner.UseCustomOverlay = true;
scanner.CustomOverlay = myCustomOverlayInstance;
var result = await scanner.Scan();
//Handle result

Keep in mind that when using a Custom Overlay, you are responsible for the entire overlay (you cannot mix and match custom elements with the default overlay). The ZxingScanner instance has a CustomOverlay property, however on each platform this property is of a different type:

  • Xamarin.iOS => UIView
  • Xamarin.Android => View
  • Windows Phone => UIElement

All of the platform samples have examples of custom overlays.

Barcode Formats

By default, all barcode formats are monitored while scanning. You can change which formats to check for by passing a ZxingScanningOptions instance into the StartScanning method:

//NOTE: On Android you should call the initialize method with an application instance
#if __ANDROID__
// Initialize the scanner first so it can track the current context
MobileBarcodeScanner.Initialize (Application);

var options = new ZXing.Mobile.MobileBarcodeScanningOptions();
options.PossibleFormats = new List<ZXing.BarcodeFormat>() { 
    ZXing.BarcodeFormat.Ean8, ZXing.BarcodeFormat.Ean13 

var scanner = new ZXing.Mobile.MobileBarcodeScanner(); 
var result = await scanner.Scan(options);
//Handle result


Samples for implementing ZXing.Net.Mobile can be found in the /sample/ folder. There is a sample for each platform including examples of how to use custom overlays.

Using the ZXingScanner View / Fragment / Control

On each platform, the ZXing scanner has been implemented as a reusable component (view, fragment, or control), and it is possible to use the reusable component directly without using the MobileBarcodeScanner class at all. On each platform, the instance of the view/fragment/control contains the necessary properties and methods required to control your scanner. By default, the default overlay is automatically used, unless you set the CustomOverlay property as well as the UseCustomOverlay property on the instance of the view/fragment/control. You can use methods such as ToggleTorch() or StopScanning() on the view/fragment/control, however you are responsible for calling StartScanning(...) with a callback and an instance of MobileBarcodeScanningOptions when you are ready for the view's scanning to begin. You are also responsible for stopping scanning if you want to cancel at any point.

The view/fragment/control classes for each platform are:

  • iOS: ZXingScannerView (UIView) - See ZXingScannerViewController.cs View Controller for an example of how to use this view
  • iOS: AVCaptureScannerView (UIView) - This is API equivalent to ZXingScannerView, but uses Apple's AVCaptureSession Metadata engine to scan the barcodes instead of ZXing.Net. See AVCaptureScannerViewController.cs View Controller for an example of how to use this view
  • Android: ZXingScannerFragment (Fragment) - See ZXingActivity.cs Activity for an example of how to use this fragment
  • Windows Phone: ZXingScannerControl (UserControl) - See ScanPage.xaml Page for an example of how to use this Control

Using Apple's AVCaptureSession (iOS7 Built in) Barcode Scanning

In iOS7, Apple added some API's to allow for scanning of barcodes in an AVCaptureSession. The latest version of ZXing.Net.Mobile gives you the option of using this instead of the ZXing scanning engine. You can use the AVCaptureScannerView or the AVCaptureScannerViewController classes directly just the same as you would use their ZXing* equivalents. Or, in your MobileBarcodeScanner, there is now an overload to use the AV Capture Engine:

//Scan(MobileBarcodeScanningOptions options, bool useAVCaptureEngine)
scanner.Scan(options, true);

In the MobileBarcodeScanner, even if you specify to use the AVCaptureSession scanning, it will gracefully degrade to using ZXing if the device doesn't support this (eg: if it's not iOS7 or newer), or if you specify a barcode format in your scanning options which the AVCaptureSession does not support for detection. The AVCaptureSession can only decode the following barcodes:

  • Aztec
  • Code 128
  • Code 39
  • Code 93
  • EAN13
  • EAN8
  • PDF417
  • QR
  • UPC-E


ZXing.Net.Xamarin is a combination of a lot of peoples' work.


Apache ZXing.Net.Mobile Copyright 2012 The Apache Software Foundation This product includes software developed at The Apache Software Foundation (


ZXing.Net.Mobile is released under the Apache 2.0 license. ZXing.Net.Mobile can be found here: A copy of the Apache 2.0 license can be found here:


ZXing.Net is released under the Apache 2.0 license. ZXing.Net can be found here: A copy of the Apache 2.0 license can be found here:


ZXing is released under the Apache 2.0 license. ZXing can be found here: A copy of the Apache 2.0 license can be found here:


The System.Drawing classes included are from the mono source code which is property of Novell. Copyright notice is intact in source code files.

You can’t perform that action at this time.