Need help with zxing-cpp?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

524 Stars 423 Forks Apache License 2.0 65 Commits 51 Opened issues


ZXing C++ Library

Services available


Need anything else?

Contributors list

ZXing C++ Port

Build Status

ZXing is/was a Java library.

At some point a complete C++ port/rewrite was created and maintained in the official ZXing repo. However, at the time of writing the C++ port is no longer maintained and has been removed from the official ZXing repo.

This project was forked from the last ZXing commit to contain the C++ project, with the following exceptions

  • scons (Python) build system has been deleted.
  • Deleted black box tests, because they refer to a large test data in ZXing repo.
  • Added appropriate copyright/licensing details (based on those in the ZXing repo).
  • Updated

Removal of build systems was done to minimise maintenance burden.

If tests and XCode projects (other than those produced automatically be CMake) are desired, then another repo should be created and this repo referenced as a submodule.

Building using CMake

CMake is a tool, that generates native makefiles and workspaces. It integrates well with a number of IDEs including Qt Creator and Visual Studio.

Usage with CLion or Qt Creator:

  1. Simply open
    as a new project
  2. Additional command line arguments can be specified (see below)

Usage with Makefiles, Visual Studio, etc. (see

cmake --help
for a complete list of generators):
  1. mkdir build
  2. cd
  3. Unix: run
    cmake -G "Unix Makefiles" ..
  4. Windows: run
    cmake -G "Visual Studio 10" ..

You can switch between build modes by specifying:


OpenCV integration

When build on a system where opencv is installed the open cv bridge classes and executable will be built too.

Development tips

To profile the code (very useful to optimize the code):

  1. Install Valgrind
  2. Run
    valgrind --tool=callgrind build/zxing - path/to/test/data/*.jpg > report.html
  3. Analyze output using KCachegrind

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.