octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Barcode Buddy for Grocy

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Available for:

• Bare Metal
• Docker $\textcolor{red}{\textsf{Attention}}$ Image name has changed!
• Android
• Kubernetes (Community support only)
• Home Assistant (Community support only)

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">About

Pass barcodes to Barcode Buddy. If already in the Grocys system, it will consume/add/open the product there.
If an unknown barcode is passed, the product name will be looked up and a corresponding product can be chosen in the Web UI.
Tags can be saved — if a new product contains the tag in the name, the product will be already preselected in the drop-down list.

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Prerequisites

Webserver that supports PHP (e.g. NGINX, Apache) or Docker, a Grocy API key and ideally a barcode scanner or Android device.

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Getting Started

Refer to the documentation, on how to install the program.
Installation can be done in a couple of minutes.

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Usage

Barcodes can either be manually added to the programm or the process can be automated by grabbing the input from the scanner.

Refer to the documentation, on how to use the program.

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Reverse Proxies

If you are using a reverse proxy, please make sure to disable caching, see documentation

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Screenshots

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Translations

Help translate the project on Hosted Weblate.

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Contributors

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Acknowledgments

• Bernd Bestel for creating the Grocy Project
• openfoodfacts.org/upcitemdb.com for providing the barcode lookup API
• PHP-Auth
• NoSleep.js
• SortableJS

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">License

This project is AGPL3+ licensed — browse the LICENSE.md file for details

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Donations

As with all Free software, the power is less in the finances and more in the collective efforts.
I really appreciate every pull request and bugreport offered up by BarcodeBuddy's users, so please keep that stuff coming.
If however, you're not one for coding/design/documentation, and would like to contribute financially, you can do so with the link below.
All help is very much appreciated!

OPEN ISSUES

RELEASES