Integrations

Integrations

Home Assistant

Smart Drink Fridge can synchronize low-stock products to a Home Assistant shopping list.

Configure the Home Assistant URL and long-lived access token under Settings. When a product reaches or drops below its configured minimum stock, it is added to the shopping list. It is removed again after restocking above the threshold.

Keep the token private and grant only the permissions required for the integration.

Pushover

Set the optional keys in .env:

PUSHOVER_USER=your_user_key
PUSHOVER_TOKEN=your_application_token

Leave both values empty when Pushover is unused.

Camera scanner

Start the scanner profile:

docker compose --profile scanner up -d

The default device is /dev/video0. A 1080p USB camera is recommended for reliable barcode recognition.

GPIO buzzer

The optional buzzer uses GPIO 17 by default:

Raspberry Pi pin	Connection
Physical pin 11 / GPIO 17	Positive
Physical pin 9 / GND	Negative

The GPIO pin can be adjusted in scanner.py.

NFC / RFID

The optional nfc Compose profile supports PC/SC USB readers such as the ACS ACR122U. The tested reader is linked on Amazon. NFC identifies the user; the camera still scans the drink barcode. Setup and privacy details are documented under User accounts and NFC.

Open Food Facts

The barcode form can query Open Food Facts for known product metadata. When lookup fails or the service is unavailable, enter the product details manually.