Chefkoch Home Assistant Sensor 👨‍🍳

The Chefkoch integration brings recipes from Germany's largest cooking platform, Chefkoch.de, directly into Home Assistant.

Features ✨

• Daily Inspiration: Automatically gets the 'Recipe of the Day'.
• Random Recipes: Discover new meals with random recipe sensors (Standard, Vegan, Baking).
• Custom Search: Create sensors for specific queries (e.g., "Lasagne", "Vegan Burger").
• Powerful Filtering: Filter by diet (Vegan, Low Carb), detailed categories, origin (Italy, Asia), and more.
• Rich Data: Attributes include ingredients, preparation time, nutritional info, and images.

Installation 🛠️

1. Using HACS (Recommended)

This integration works great with HACS.

1. Open HACS.
2. Search for "Chefkoch".
3. Click Download.

Tip

HACS updates the component automatically.

2. Manual Installation

1. Download the latest Release.
2. Extract the ZIP file.
3. Copy the chefkoch_ha folder to <config>/custom_components/.

Warning

Downloading directly from master branch is not recommended.

Configuration ⚙️

1. Go to Settings -> Devices & Services.
2. Click Add Integration.
3. Search for "Chefkoch".

Accessing the data

There will be four new sensors after adding it via HA:

• sensor.chefkoch_random_recipe: Random recipe
• sensor.chefkoch_daily_recipe: Daily recipe recommendation from chefkoch
• sensor.chefkoch_vegan_recipe: Vegan recipe
• sensor.chefkoch_random_baking_recipe: Random baking recipe

Custom Search Sensors

You can create sensors that match your exact needs.

1. Go to Settings > Devices & Services and find your Chefkoch integration.
2. Click Configure.
3. Select "Add a new Search Sensor".
4. Fill out the form with your desired filters.

Available Filters

Note

Values must be in German as they are passed directly to the Chefkoch API.

Full details here

• Sensor Name: Friendly name (e.g., "Quick Pasta").
• Search Term: Main keyword (e.g., "Lasagne").
• Properties: Einfach, Schnell, Basisrezepte, Preiswert.
• Diet: Vegetarisch, Vegan, Kalorienarm, Low Carb, Ketogen, Paleo, Fettarm, Trennkost, Vollwert.
• Categories: Auflauf, Pizza, Salat, Suppe, Kuchen, Dessert, etc.
• Countries: Italien, Asien, Indien, Mexiko, Deutschland, etc.
• Meal Type: Hauptspeise, Vorspeise, Beilage, Dessert, Snack, Frühstück.
• Max. Preparation Time: In minutes.
• Minimum Rating: Alle, 2, 3, 4, Top.

You can add, edit, or remove your custom search sensors at any time through the same Configure menu.

Automation Example

Send a notification with the daily recipe:

alias: "Daily Random Recipe"
description: "Sends a daily random recipe message with attribute details."
mode: single
trigger:
  - platform: time
    at: "09:00:00"
action:
  - service: notify.notify
    data:
      title: "Recipe of the Day 👨‍🍳"
      message: >
        Here's a random recipe for you today! 🎉

        **Recipe:** {{ states('sensor.chefkoch_random_recipe') }}

        **Preparation Time:** {{ state_attr('sensor.chefkoch_random_recipe', 'totalTime') }}
        **Calories:** {{ state_attr('sensor.chefkoch_random_recipe', 'calories') }}
        **Category:** {{ state_attr('sensor.chefkoch_random_recipe', 'category') }}

        [View Recipe]({{ state_attr('sensor.chefkoch_random_recipe', 'url') }})
      data:
        image: "{{ state_attr('sensor.chefkoch_random_recipe', 'image_url') }}"

Forcing an Update

If you don't want to wait for the daily refresh, you can force all Chefkoch sensors to update:

service: homeassistant.reload_config_entry
target:
  entity_id: sensor.chefkoch_random_recipe # Any chefkoch sensor works

Troubleshooting & Bug Reporting

Open an issue over at GitHub Issues. Please attach logs with debugging enabled.

To enable debugging:

logger:
  logs:
    custom_components.chefkoch_ha: debug

Credits

Huge thanks to @THDMoritzEnderle for the underlying python library.