98 lines
3.8 KiB
Markdown
98 lines
3.8 KiB
Markdown
# CookCLI Recipes pour Home Assistant
|
|
|
|
Intégration Home Assistant permettant de parcourir vos recettes de cuisine depuis un serveur [CookCLI](https://github.com/cooklang/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](https://hacs.xyz/)** installé (recommandé)
|
|
|
|
### Installation via HACS
|
|
|
|
1. Ouvrez **HACS** dans Home Assistant.
|
|
2. Allez dans **Intégrations** → menu (⋮) → **Dépôts personnalisés**.
|
|
3. Ajoutez l'URL du dépôt :
|
|
```
|
|
https://git.thethomaas.net/TheThomaas/ha-cookcli
|
|
```
|
|
Catégorie : **Intégration**
|
|
4. Recherchez **CookCLI** dans HACS et installez-le.
|
|
5. **Redémarrez Home Assistant.**
|
|
|
|
### Installation manuelle
|
|
|
|
1. Téléchargez ou clonez ce dépôt.
|
|
2. Copiez le dossier `custom_components/cookcli` dans le répertoire `config/custom_components/` de votre instance Home Assistant.
|
|
3. **Redémarrez Home Assistant.**
|
|
|
|
## ⚙️ Configuration
|
|
|
|
1. Dans Home Assistant, allez dans **Paramètres** → **Appareils et services**.
|
|
2. Cliquez sur **Ajouter une intégration**.
|
|
3. Recherchez **CookCLI**.
|
|
4. Renseignez les informations demandées :
|
|
- **Hôte / URL du serveur CookCLI** (ex. `http://192.168.1.10:9080`)
|
|
- **Port** si nécessaire
|
|
5. 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) :
|
|
|
|
```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](./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.* |