Project

zbar

No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Ruby bindings for ZBar, a barcode recognition library. Uses FFI to interact with the underlying C library, but has no other dependencies.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
 Dependencies

Development

~> 1.16
~> 2.1
~> 12.2
~> 5.1
~> 3.7
~> 1.2

Runtime

~> 1.0
 Project Readme

zbar Build Status¶ ↑

by Will Glynn

github.com/willglynn/ruby-zbar

Description:¶ ↑

Ruby bindings for ZBar, a barcode recognition library.

Synopsis:¶ ↑

require 'zbar'

ZBar::Image.from_jpeg(File.binread('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¶ ↑

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit. Don't change VERSION, or if you do, do it in a separate commit.

  • Send me a pull request. Bonus points for topic branches.

  • Watch the Travis-CI build status on your pull request. Fix any problems.

Copyright © 2010-2013 Will Glynn. See LICENSE for details.