CookCLI Recipes pour Home Assistant

Intégration Home Assistant permettant de parcourir vos recettes de cuisine depuis un serveur CookCLI.

Cette intégration fonctionne main dans la main avec une stratégie de tableau de bord et une carte personnalisée pour offrir une expérience complète : navigation parmi les recettes, page de détail par recette, affichage des ingrédients et des étapes.

✨ Fonctionnalités

📖 Parcourir vos recettes directement depuis Home Assistant
🗂️ Tableau de bord automatique : une page est générée pour chaque recette
🥕 Vue détaillée de chaque recette : ingrédients et étapes de préparation
🧭 Carte de navigation : liste toutes les recettes et permet de naviguer vers la page de détail

📦 Installation

Prérequis

Une instance Home Assistant fonctionnelle (version récente recommandée)
Un serveur CookCLI accessible depuis Home Assistant
HACS installé (recommandé)

Installation via HACS

Ouvrez HACS dans Home Assistant.
Allez dans Intégrations → menu (⋮) → Dépôts personnalisés.

Ajoutez l'URL du dépôt :

https://git.thethomaas.net/TheThomaas/ha-cookcli

Catégorie : Intégration

Recherchez CookCLI dans HACS et installez-le.
Redémarrez Home Assistant.

Installation manuelle

Téléchargez ou clonez ce dépôt.
Copiez le dossier custom_components/cookcli dans le répertoire config/custom_components/ de votre instance Home Assistant.
Redémarrez Home Assistant.

⚙️ Configuration

Dans Home Assistant, allez dans Paramètres → Appareils et services.
Cliquez sur Ajouter une intégration.
Recherchez CookCLI.
Renseignez les informations demandées :
- Hôte / URL du serveur CookCLI (ex. http://192.168.1.10:9080)
- Port si nécessaire
Validez.

🚀 Utilisation

Carte des recettes

Ajoutez la carte cookcli-card à un tableau de bord pour afficher la liste de toutes vos recettes. Cliquer sur une recette vous amène vers sa page de détail.

Options disponibles :

title : Titre de la carte. Par défaut : « Recettes ».
tag : N'afficher que les recettes portant ce tag. Vide = toutes les recettes.
show_tag_filter : Affiche des pills cliquables en haut de la liste pour filtrer par tag.
dashboard_path : Seulement si la carte n'est pas sur le dashboard qui contient les vues recettes.
entry_id : Seulement si tu as plusieurs serveurs CookCLI. Vide = le serveur par défaut.

Exemple (YAML) :

type: custom:cookcli-card
title: Mes recettes

Stratégie de tableau de bord

La stratégie cookcli-recipe-strategy génère automatiquement un tableau de bord avec une page par recette. Chaque page affiche :

la liste des ingrédients,
les étapes de préparation.

Options disponibles :

title : Titre de la liste et du dashboard. Par défaut : « Recettes ».
timer_entity : Aide « Minuteur » partagée entre toutes les recettes (ex. timer.recette_en_cours). Vide = pas de boutons de minuteur.
step_entity : Aide « Nombre » qui pilote l'onglet actif (ex. input_number.recette_etape). Vide = pas de boutons Commencer / Précédent / Suivant.
entry_id : Seulement si tu as plusieurs serveurs CookCLI. Vide = le serveur par défaut.

Pour l'utiliser, créez un nouveau tableau de bord et sélectionnez la stratégie CookCLI, ou référencez-la dans votre configuration de tableau de bord.

📄 Licence

Ce projet est distribué sous licence présente dans le fichier LICENSE du dépôt.

🔗 Liens

CookCLI : https://github.com/cooklang/CookCLI
Cooklang : https://cooklang.org/

Projet non officiel, non affilié à Home Assistant ni à Cooklang.

3.8 KiB Raw Permalink Blame History