TheThomaas/ha-cookcli-card
Archived
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
This repository has been archived on 2026-09-19. You can view files and clone it, but cannot push or open issues or pull requests.
21 commits 1 branch 0 tags 127 KiB
Go to file
TheThomaas 2dd6c4fe02 Update README.md
2026-09-16 18:07:16 +02:00
dist Update cookcli-card.js 2026-09-16 16:28:06 +02:00
hacs.json Initial commit 2026-09-15 19:19:36 +02:00
LICENSE Initial commit 2026-09-15 19:19:36 +02:00
README.md Update README.md 2026-09-16 18:07:16 +02:00

README.md

CookCLI Card pour Home Assistant

Carte Lovelace personnalisée pour Home Assistant qui affiche la liste de toutes vos recettes exposées par l'intégration ha-cookcli, et permet de naviguer vers la page de détail de chaque recette générée par la stratégie ha-cookcli-strategy.

✨ Fonctionnalités

  • 📋 Liste toutes vos recettes de cuisine dans une carte unique
  • 🧭 Navigation vers la page de détail d'une recette au clic
  • 🎨 Carte Lovelace personnalisée (custom:cookcli-card) intégrable dans n'importe quel tableau de bord
  • 🔌 Fonctionne avec les données exposées par l'intégration ha-cookcli

🧩 Architecture

Cette carte fait partie d'un ensemble de trois composants qui fonctionnent ensemble :

Composant Rôle Dépôt
Intégration Se connecte au serveur CookCLI et expose les recettes à Home Assistant ha-cookcli
Stratégie de tableau de bord Crée automatiquement une page par recette (ingrédients + étapes) ha-cookcli-strategy
Carte personnalisée Liste toutes les recettes et permet de naviguer vers le détail d'une recette ce dépôt

📦 Installation

Prérequis

  • Une instance Home Assistant fonctionnelle (version récente recommandée)
  • L'intégration ha-cookcli installée et configurée
  • La stratégie ha-cookcli-strategy installée (pour les pages de détail)
  • HACS installé (recommandé)

Installation via HACS

  1. Ouvrez HACS dans Home Assistant.
  2. Allez dans Tableaux de bord → menu (⋮) → Dépôts personnalisés.
  3. Ajoutez l'URL du dépôt : 
    https://git.thethomaas.net/TheThomaas/ha-cookcli-card
    Catégorie : Dashboard (ou Lovelace)
  4. Recherchez CookCLI Card dans HACS et installez-le.
  5. Videz le cache du navigateur ou rechargez les ressources Lovelace.

Installation manuelle

  1. Téléchargez ou clonez ce dépôt.
  2. Copiez le fichier dist/cookcli-card.js dans votre répertoire config/www/.
  3. Ajoutez la ressource dans Paramètres → Tableaux de bord → Ressources : 
    url: /local/cookcli-card.js
type: module
  4. Rechargez les ressources Lovelace.

⚙️ Configuration

Ajout de la carte

Ajoutez la carte cookcli-card à n'importe quel tableau de bord. Exemple minimal en YAML :

type: custom:cookcli-card

Exemple avec titre

type: custom:cookcli-card
title: Mes recettes

Consultez le fichier dist/cookcli-card.js pour la liste complète des options supportées (filtres, tri, titre, etc.).

Via l'éditeur visuel

  1. Ouvrez un tableau de bord en mode édition.
  2. Cliquez sur + Ajouter une carte.
  3. Recherchez CookCLI Card.
  4. Configurez les options puis validez.

🚀 Utilisation

  1. La carte affiche la liste de toutes vos recettes récupérées depuis l'intégration.
  2. Cliquez sur une recette pour être redirigé vers sa page de détail (générée par la stratégie).
  3. La page de détail affiche les ingrédients et les étapes de préparation.

📄 Licence

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

🔗 Liens