Skip to content
/ grocy Public
forked from custom-components/grocy

Custom Grocy integration for Home Assistant

License

Apache-2.0 license
0 stars 50 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

misa1515/grocy

BranchesTags
 
 

Repository files navigation

hacs_badge

INFO

The integration supports Grocy version 3.2 and above.

At least Home Assistant version 2021.12 is required for the integration from v4.3.3 and above.

You have to have the Grocy software already installed and running, this integration only communicates with an existing installation of Grocy. You can install the software with the Grocy add-on or another installation method, found at Grocy website.

Adding the integration

First steps for Grocy add-on

The configuration is slightly different for those who use the official Grocy add-on from the add-on store.

  1. If you haven't already done so, install Grocy from the add-on store.
  2. In the 'Configuration' section of the add-on config, input 9192 in the Network port field - see screenshot. Save your changes and restart the add-on.
  3. Now continue with the instructions below.

Instructions for both installation methods

  1. Install HACS, if you haven't already done so.
  2. In Home Assistant go to HACS > Integrations. Search for the "Grocy custom component" repository by clicking the "Explore & download repositories" button in the bottom right corner.
  3. In the bottom right corner click "Download the repository with HACS". Click "Download". Optional: for latest features and fixes choose "Show beta versions".
  4. Restart Home Assistant as instructed by HACS.
  5. Install the Grocy integration. Fill out the information according to this instruction.
  6. Before integration version v4.3.3, now restart Home Assistant again (with later versions you can skip this step).
  7. You will now have a new integration for Grocy. All entities are disabled from start, manually enable the entities you want to use.

Future integration updates will appear automatically within Home Assistant via HACS.

Entities

All entities are disabled from the start. You have to manually enable the entities you want to use in Home Assistant. You get a sensor each for chores, meal plan, shopping list, stock, tasks and batteries. You get a binary sensor each for overdue, expired, expiring and missing products and for overdue tasks, overdue chores and overdue batteries.

Services

The following services come with the integration. For all available options check the Developer Tools: Services within Home Assistant.

  • Grocy: Add Generic (grocy.add_generic)

Adds a single object of the given entity type.

  • Grocy: Add Product To Stock (grocy.add_product_to_stock)

Adds a given amount of a product to the stock.

  • Grocy: Open Product (grocy.open_product)

Opens a given amount of a product in stock.

  • Grocy: Track Battery (grocy.track_battery)

Tracks the given battery.

  • Grocy: Complete Task (grocy.complete_task)

Completes the given task.

  • Grocy: Consume Product From Stock (grocy.consume_product_from_stock)

Consumes a given amount of a product from the stock.

  • Grocy: Execute Chore (grocy.execute_chore)

Executes the given chore with an optional timestamp and executor.

  • Grocy: Consume Recipe (grocy.consume_recipe)

Consumes the given recipe.

Translations

Translations are done via Lokalise. If you want to translate into your native language, please join the team.

Troubleshooting

If you have problems with the integration you can add debug prints to the log.

logger:
  default: info
  logs:
    pygrocy.grocy_api_client: debug
    custom_components.grocy: debug

If you are having issues and want to report a problem, always start with making sure that you're on the latest beta version of the integration, Grocy and Home Assistant.

You can ask for help in the forums, or make an issue with all of the relevant information here.

Integration configuration