zbar <img src=“https://travis-ci.org/willglynn/ruby-zbar.png?branch=travis” alt=“Build Status” />

by Will Glynn

Description:

Ruby bindings for ZBar, a barcode recognition library.

Synopsis:

require 'zbar'

ZBar::Image.from_jpeg(File.read('test.jpg')).process
=> [#<Zbar::Symbol:0x10147c668
  @addon="",
  @data="9876543210128",
  @location= [...],
  @quality=15,
  @symbology="EAN-13">]

Download/install:

Add to your Gemfile:

gem "zbar"

Otherwise:

$ [sudo] gem install zbar

You’ll also need the zbar C library to make it work. This might be available from your package manager:

$ sudo apt-get install libzbar0    # on Debian or Ubuntu
$ sudo emerge zbar                 # on Gentoo
$ brew install zbar                # on Mac OS X with Homebrew

Alternately, install from source at zbar.sf.net/.

Limitations:

Doesn’t expose all ZBar functionality, including:

No video functions
No low-level interfaces (scanner, decoder)

Additionally, there is a zbar <= 0.10 issue with JPEG decoding; see lib/zbar/jpeg.rb for more. You can check your ZBar::JPEG.bugged? status if you’re curious. Otherwise, just try using it, and see if you get a warning on stderr.

Contributing