♻️ Garbage Collection (fork FR)
Cette intégration Home Assistant permet de créer des capteurs personnalisés pour gérer les calendriers de collecte des déchets.
🍴 Fork personnel
Ce dépôt est un fork personnel de : https://github.com/bruxy70/Garbage-Collection
L’intégration originale n’est plus activement maintenue depuis fin 2022.
✨ Modifications apportées dans ce fork
🇫🇷 Gestion intégrée des jours fériés
Ajout d’une fonctionnalité native permettant de décaler automatiquement les collectes si un jour férié est détecté dans la semaine.
- Utilise la librairie Python
holidays - Aucun blueprint externe requis
- Fonctionne avec un code pays (par défaut : FR)
- Analyse la semaine ISO complète
- Décale la collecte d’un jour si nécessaire (avec propagation si jours fériés consécutifs)
⚠️ Compatibilité Home Assistant
Compatible Home Assistant récent (2024+ / 2026)
Corrections incluses :
- remplacement de
async_forward_entry_setup(obsolète) - utilisation de
async_forward_entry_setups - support du reload dynamique des options
📦 Installation
Installation manuelle
- Copier le dossier :
- Redémarrer Home Assistant
- Ajouter l’intégration via l’interface
Installation via HACS
- Ajouter ce dépôt dans HACS (Custom repository)
- Installer “Garbage Collection”
- Redémarrer Home Assistant
- Configurer via l’interface
⚙️ Configuration
Configuration via : Paramètres → Appareils et services → Ajouter un assistant (Helper)
🧩 Fonctionnalités
- 📅 Hebdomadaire
- 🔁 Toutes les X semaines
- 📆 Tous les X jours
- 🗓️ Mensuel (n-ième semaine ou jour du mois)
- 🎂 Annuel
- 🔗 Groupement de capteurs
- ✋ Mode manuel avancé
🧪 États du capteur
| État | Signification |
|---|---|
| 0 | Collecte aujourd’hui |
| 1 | Collecte demain |
| 2 | Collecte plus tard |
📊 Attributs
next_date→ prochaine collectedays→ jours restantslast_collection→ dernière collecte
🛠️ Services
garbage_collection.collect_garbagegarbage_collection.update_stategarbage_collection.add_dategarbage_collection.remove_dategarbage_collection.offset_date
🧠 Mode avancé
Permet des règles personnalisées via automations Home Assistant.
⚠️ réservé aux utilisateurs avancés
📅 Jours fériés
- détection automatique
- décalage des collectes
- configuration par pays (
holiday_country)
❤️ Remarque
Ce fork est personnel et expérimental. Il peut diverger du projet original.
📜 Licence
Basé sur le projet original de bruxy70. Même licence que l’original.