Open Food Facts Android Application
===================================

[![Project Status](http://opensource.box.com/badges/active.svg)](http://opensource.box.com/badges)
[![Build Status](https://travis-ci.org/openfoodfacts/openfoodfacts-androidapp.svg?branch=master)](https://travis-ci.org/openfoodfacts/openfoodfacts-androidapp)
[![Stories in Ready](https://badge.waffle.io/openfoodfacts/openfoodfacts-androidapp.svg?label=ready&title=Ready)](https://waffle.io/openfoodfacts/openfoodfacts-androidapp)
[![Average time to resolve an issue](https://isitmaintained.com/badge/resolution/openfoodfacts/openfoodfacts-androidapp.svg)](https://isitmaintained.com/project/openfoodfacts/openfoodfacts-androidapp "Average time to resolve an issue")
[![Percentage of issues still open](https://isitmaintained.com/badge/open/openfoodfacts/openfoodfacts-androidapp.svg)](https://isitmaintained.com/project/openfoodfacts/openfoodfacts-androidapp "Percentage of issues still open")
[![Crowdin](https://d322cqt584bo4o.cloudfront.net/openfoodfacts/localized.svg)](https://crowdin.com/project/openfoodfacts)
[![Open Source Helpers](https://www.codetriage.com/openfoodfacts/openfoodfacts-androidapp/badges/users.svg)](https://www.codetriage.com/openfoodfacts/openfoodfacts-androidapp)
<br>
<img src="https://static.openfoodfacts.org/images/misc/openfoodfacts-logo-en-178x150.png">
## What is Open Food Facts?

<a href="https://f-droid.org/app/openfoodfacts.github.scrachx.openfood"><img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="70"></a><a href="https://play.google.com/store/apps/details?id=openfoodfacts.github.scrachx.openfood"><img src=https://play.google.com/intl/en_us/badges/images/badge_new.png></a><br>
(These are beta versions, <a href="https://play.google.com/store/apps/details?id=org.openfoodfacts.scanner">this is the stable version</a>)

<img src="https://lh3.googleusercontent.com/8WatIseTIIFe5dLA2Gje3CVFZkiLWKVkt4RjuxtdQk56G1MEHmQ5cR57ICQnTFaSLss=h900" height="300"><img src="https://lh3.googleusercontent.com/xSkBdFey8CNhIN7lBjAWGzuMd6hTdfKNeeWI0dchehqyL3CgyU7jER5C5dM_CzwQyJA=h900" height="300"><img src="https://lh3.googleusercontent.com/bbDgVhz73xXZzA2-QjkvP3V0aFeX9iys5lh2vWmjMsg4UlMXERBxoRqAGcgW6YFbJaET=h900" height="300"><img src="https://lh3.googleusercontent.com/bL1v0l8BKfHQG2x4k-macPi5w3dGLbxGDaBuRPtKTzXE56-HXQmNXk0Ew60v1Kyh3g=h900" height="300">

### A food products database

Open Food Facts is a database of food products with ingredients, allergens, nutrition facts and all the tidbits of information we can find on product labels.

### Made by everyone

Open Food Facts is a non-profit association of volunteers.
7000+ contributors like you have added 450 000+ products from 150 countries using our Android, iPhone or Windows Phone app or their camera to scan barcodes and upload pictures of products and their labels.

### For everyone

Data about food is of public interest and has to be open. The complete database is published as open data and can be reused by anyone and for any use. Check-out the cool reuses or make your own!
- <https://world.openfoodfacts.org>

## Translations

### Translate Open Food Facts in your language

You can help translate Open Food Facts and the app at (no technical knowledge required, takes a minute to signup): <br>
https://crowdin.com/project/openfoodfacts

Watch the [topic](https://github.com/openfoodfacts/openfoodfacts-androidapp/issues/49).

## Bugs and feature requests

Have a bug or a feature request? Please search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

## Installation

* Android Studio should be the latest stable build. You can get it from [Here](https://developer.android.com/studio/index.html)
* If you're running the app for the first time android-studio will ask you to install the Gradle dependencies if you haven't already, Just click install.
* If you're a new contributor to open-source, We recommend you to read our [Setup Guidelines](https://github.com/openfoodfacts/openfoodfacts-androidapp/blob/master/SETUP_GUIDELINES.md)



## Waffle Throughput Graph

[![Throughput Graph](https://graphs.waffle.io/openfoodfacts/openfoodfacts-androidapp/throughput.svg)](https://waffle.io/openfoodfacts/openfoodfacts-androidapp/metrics/throughput)

## Libraries used

- https://loopj.com/android-async-http/
- http://jackson.codehaus.org
- https://github.com/code-mc/loadtoast
- https://github.com/dm77/barcodescanner
- https://github.com/koush/ion
- https://jsoup.org/
- https://github.com/satyan/sugar
- https://github.com/afollestad/material-dialogs
- https://github.com/jjhesk/LoyalNativeSlider
- https://github.com/mikepenz/MaterialDrawer
- and others (see gradle)

Big thanks to them!

## Contributing

The project is initially started by [Scot Scriven](https://github.com/itchix), other contributors include:
- [Aurélien Leboulanger](https://github.com/herau)
- [Pierre Slamich](https://github.com/teolemon)
- [Friedger Müffke](https://github.com/friedger)
- [Qian Jin](https://github.com/jinqian)

If you're new to open-source, we recommend you to checkout our [_Contributing Guidelines_](https://github.com/openfoodfacts/openfoodfacts-androidapp/blob/master/CONTRIBUTING.md). Feel free to fork the project and send us a pull request.

Here's a few list of bugs:
- Very high impact: https://github.com/openfoodfacts/openfoodfacts-androidapp/labels/very%20high%20impact
- Priority: https://github.com/openfoodfacts/openfoodfacts-androidapp/labels/priority

## Copyright and License

    Copyright 2016-2018 Open Food Facts

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

       https://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and 
    limitations under the License.
