Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mchehab/zbar

ZBar is an open source software suite for reading bar codes from various sources, including webcams. As its development stopped in 2012, I took the task of keeping it updated with the V4L2 API. This is the main repository for it. There's a clone at at LinuxTV.org, and another one at gitlab.
https://github.com/mchehab/zbar

barcode barcode-scanner linux v4l2

Last synced: 3 days ago
JSON representation

Host: GitHub
URL: https://github.com/mchehab/zbar
Owner: mchehab
License: lgpl-2.1
Created: 2018-08-08T10:52:40.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2024-07-30T02:39:13.000Z (3 months ago)
Last Synced: 2024-10-28T05:12:56.194Z (14 days ago)
Topics: barcode, barcode-scanner, linux, v4l2
Language: C
Homepage: https://linuxtv.org/downloads/zbar/
Size: 5.14 MB
Stars: 972
Watchers: 33
Forks: 203
Open Issues: 117
Metadata Files:
- Readme: README-windows.md
- Changelog: ChangeLog
- License: COPYING

Awesome Lists containing this project

stars - mchehab/zbar

README

ZBAR BAR CODE READER
====================

ZBar Bar Code Reader is an open source software suite for reading bar codes
from various sources, such as video streams, image files and raw intensity
sensors. It supports EAN-13/UPC-A, UPC-E, EAN-8, Code 128, Code 93, Code 39,
Codabar, Interleaved 2 of 5 and QR Code. Included with the library are basic
applications for decoding captured bar code images and using a video device
(e.g. webcam) as a bar code scanner. For application developers, language
bindings are included for C, C++, Python and Perl as well as GUI widgets for
Qt, GTK and PyGTK.

Check the ZBar home page for the latest release, mailing lists, etc.

License information can be found in 'COPYING'.

Once built, the Windows binaries will use binaries of several supporting
libraries, each one with its own copyright, license and source code locations.

It follows a non-exhaustive list of those components:

* The GNU libiconv character set conversion library

Licensed under LGPL. The source code is available from

* The ImageMagick software imaging library

Licensed under a derived Apache 2.0 license:

* https://imagemagick.org/script/license.php

The source code is available from

* The libxml2 XML C parser and toolkit

Licensed under the MIT license.

The source code is available from:

* JPEG library

The Independent JPEG Group's software's version is:

Libjpeg-turbo has additional copyrights:

Licensed under BSD-style licenses with their own terms:

* https://www.ijg.org/files/README
* https://github.com/libjpeg-turbo/libjpeg-turbo/blob/master/LICENSE.md

The source code is available from:

* libtiff, a library for reading and writing TIFF

Licensed under a BSD-style license.

The source code is available from

* libpng, the official PNG reference library

Licensed under a BSD-style license.

The source code is available from

* The zlib general purpose compression library

Licensed under a BSD-style license.

The source code is available from

* The bzip2 compression library

Licensed under a BSD-style license.

The source code is available from

* Depending on how this is packaged, other licenses may apply

BUILDING
========

NOTE: this is a simplified version of what it was done in order to do the
Travis CI builds. You may use this as a guide, but the instructions here
may be incomplete. If you find inconsistencies, feel free to submit patches
improving the building steps.

Also, please notice that the instructions here is for a minimal version,
without any bindings nor ImageMagick.

Building on Ubuntu Bionic
-------------------------

You need to install the following packages:

sudo apt-get install -y \
autoconf automake autotools-dev libdbus-1-dev \
pkg-config binutils-mingw-w64-i686 gcc-mingw-w64 \
mingw-w64-i686-dev mingw-w64-common win-iconv-mingw-w64-dev \
xmlto autopoint

Then, build Zbar with:

export PKG_CONFIG_PATH=/usr/x86_64-w64-mingw32/lib/pkgconfig

autoreconf -vfi

CC=i686-w64-mingw32-gcc ./configure --host=i686-w64-mingw32 \
--prefix=/usr/local/win32 --with-directshow \
--without-gtk --without-python --without-qt --without-java \
--without-imagemagick --enable-pthread

make

Building natively on Windows
----------------------------

It is possible to build it natively on Windows too.

You need first to setup a building environment with minGw. One way would
be to use Chocolatey to download what's needed:

* https://chocolatey.org/

With Cocolatey installed, ensure that you have minGw and needed deps with:

choco install -r --no-progress -y msys2 make

Then use pacman to install the needed packages:

pacman -Syu --noconfirm autoconf libtool automake make \
autoconf-archive pkg-config autopoint gettext-devel

Once you have everything needed and set the PATH to the places where the
building environment is, you can build ZBar with:

autoreconf -vfi

./configure \
--host=i686-w64-mingw32 --prefix=/usr/local/win32 \
--without-gtk --without-python --without-qt --without-java \
--without-imagemagick --enable-pthread \
--with-directshow --disable-dependency-tracking

make

RUNNING
=======

This version of the package includes *only command line programs*.
(The graphical interface is scheduled for a future release)

Invoke Start -> Programs -> ZBar Bar Code Reader -> Start ZBar Command Prompt
to open a shell that has the zbarimg and zbarcam commands available
(in the PATH).

To start the webcam reader using the default camera, type:

zbarcam

To decode an image file, type e.g.:

zbarimg -d examples\barcode.png

For basic command instructions, type:

zbarimg --help
zbarcam --help

Check the manual for more details.

REPORTING BUGS
==============

Bugs can be reported at the GitHub project page

Please include the ZBar version number and a detailed description of
the problem. You'll probably have better luck if you're also familiar
with the concepts from: