Skip to content

Ma configuration Home Assistant commentée en anglais et en français | My Home Assistant config with French and English comments.

License

Notifications You must be signed in to change notification settings

oncleben31/home-assistant-config

Repository files navigation

My Home Assistant config

Project Maintenance License

Github workwlow GitHub Activity GitHub Last Commit

Discord francophone Forum francophone Awesome francophone

Official Discord Official community Forum

Welcome to my Home Assistant configuration! Bienvenue chez ma configuration Home Assistant !

You will find English README content here.

Vous trouverez le contenu en français du README ici.

Pour les francophones

Ne soyez pas effrayés par la structure non standard de cette configuration pour Home-Assistant. J'ai été inspiré par la structure propsée par Franck Nijhof.

Cette approche est très modulaire et très différente dans sa strucutre des autres configurations que vous trouverez sur Internet.

L'idée c'est que chaque fichier dans ce dépôt ne fait qu'une seule chose ! Vous pouvez ainsi chercher le fichier qui correspond à un composant, cliquez et vous trouverez rapidement l'information. Le fichier configuration.yaml n'est utilisé que pour amorcer le système et contient des paramètres minimaux, mais vitaux.

Si vous êtes à l'aise en anglais, je conseille le visionnage de la video de Franck expliquant pourquoi il a fait ces choix.

J'ai essayé d'ajouter des commentaires et des liens vers la documentation pour chaque fichier YAML quand cela à une valeur ajoutée.

Attention: ma décision d'avoir une documentation bilingue en ajoutant le français a été faite dans un second temps. Donc la partie francophone n'est pas encore complète.

Si vous avez des questions ou voulez discuter de ma configuration, vous pouvez me retrouver sur le réseau HACF (forum, Discord, organisation GitHub, etc...) où on y parle français ou sur le réseau Home Assistant officiel.

Appareils utilisés

  • Un Microseveur HP Gen8 pour héberger un Machine Virtuelle HassOS
  • Les objets Xiaomi:
    • Robot aspirateur Roborock cleaner
    • Pleins de capteurs et interrupteurs
  • Zwaves:
    • Prises avec contrôle de la consomation
    • Détecteurs incendies
  • RFXCOM pour accéder à des capteurs Oregon
  • Ampoules Philips Hue et appareils Zigbee compatibles
  • Quelques objets DIY à base d'esp32 en utilisant ESPHome
  • Telegram pour les notifications
  • Google home et Chromecast
  • Renault Zoé ma voiture électrique
  • Linky
  • Serveur Plex qui tourne sur mon NAS
  • Conbee 2 pour controler mes appareils Zigbee (Xiaomi, Hue and OSRAM)
  • UPC Back-UPS pour protéger des coupures électriques mon Microserveur, mon switch et mon NAS.
  • Un Sonoff POW R2 gérer la pompe de filtration de ma piscine
  • Un NAS Synology
  • Une imprimante Brother
  • Une Livebox pour ma connexion ADSL.
  • Les téléphones de la maisons (iOS et Android)

Automations

Vous trouverez dans mes scripts et automations les fonctionalités suivantes:

  • Un backup régulier de ma configuration Home-Assistant.
  • Surveiller la disponibilité des appareils critiques de ma maison.
  • Surveiller la qualité de ma connexion Internet.
  • Piloter le robot Aspirteur à partir de Google Home.
  • Les routines quotidiennes pour nettoyer avec le robot aspirateur.
  • Gestion d'un alarme (besoin de retravailler cette partie).
  • Vérification et notification si des lumières devraient être éteintes
  • Envoie une notification en cas d'alerte météo ou de pluie attendue
  • Envoie un notification si j'ai oublié de brancher ma voiture électrique
  • Piloter le calendrier de la pompte de filtration de la piscine.
  • Et pleins d'autre choses...

les Custom components utilisés

Les custom components qui m'aident:

  • HACS* pour gérer la mise à jour des composants utilisés.
  • variable* merci à rogro82 pour la création et Wibias pour la maintenance.
  • Pool Pump Manager* pour piloter la pompe de filtration de ma piscine. Merci à moi même ;-) et à exxamalte pour l'inspiration de son module pool-pump
  • Orange Livebox Router* pour récupérer des information de ma livebox. Merci à Cyr-ius
  • Blitzortung.org lightning detector* pour détecter les orages près de chez moi. Merci à mrk-its.

(*): intégrations gérées avec HACS

Integrations configurées via l'IHM dans HA

Les integrations suivantes ne sont pas configurées dans les fichiers YAML. Vous ne les verrez donc pas dans ce dépôt:

  • Application mobile pour intégrer les informations des smartphones de la famille.
  • Blitzortung (cf. liste des customs components).
  • Brother pour avoir l'état de mon imprimante.
  • CO2 Signal
  • deCONZ pour piloter mes appareils Zigbee.
  • ESPHome pour intégrer des ESP ou SONOFF.
  • IFTTT utilisé pour piloter le robot aspirateur par la voix.
  • Google Cast utilisé pour envoyer des message TTS sur ma Google Home
  • Météo-France pour avoir la météo, les alertes météo et la prévision de pluie dans l'heure.
  • Network UPS Tool (NUT) pour surveiller mon UPC Back-UPS. Pour les NAS synology il y a une astuce sur le site de Cachem.fr
  • Livebox (cf. liste des customs components).
  • Plex pour connceter mon serveur Plex
  • Renault pour remonter les information de ma Zoe. Big up a @epenet qui a investi beaucoup d'energie (avec un peu de mon aide) pour rendre cette integration officielle et aboutie.
  • RFXTRX pour gérer mes appareils radios.
  • SpeedTest pour surveiller ma connexion ADSL.
  • Synology pour surveiller mon NAS.
  • Waze pour surveiller la durée des trajets quotidiens de la famille.

Addons utilisés

One more thing

J'ai ajouté d'autres information spécifiques dans le wiki. N'oubliez pas de le visiter. Attention pas encore traduit.

Me contacter

Si vous voulez discuter de ma configuration, vous pouvez le faire à travers les outils suivant:

For English speaking users

Don't be scared by the non standard structure of the Home Assistant configuration folder. I'm inspired by the strucutre propsed by Franck Nijhof.

This system is very modular and very differently structured compared to other,configurations you'll find online.

Basically, each file in the repository does 1 (one, uno, eins) thing only! Search file with the name of the component, click through it, you'll get it pretty fast. The configuration.yaml is only used to bootstrap the system and contains some minimal, but vital, settings.

You can watch a video by Franck explaining why is doing that way.

I try to add comments and link with external documentations for each YAML file when needed.

If you have questions or want to discuss about my configuration, you can reach me on the HACF network (forum, Discord, GitHub organization, etc...) where we speak French or on the official Home Assistant network.

Devices used

  • A Microserver HP Gen8 to host a HassOS Virtual Machine
  • Xiaomi devices:
    • Vacuum Roborock cleaner
    • Lot of sensors and switchs
  • Zwaves:
    • Switchs with energy monitoring
    • Fire detectors
  • RFXCOM to access Oregon sensors
  • Philips Hue bulbs and compatible Zigbee devices
  • DIY with esp32 using ESPHome
  • Telegram
  • Google home and Chromecast
  • Renault Zoé my electric car
  • Linky electrcity monitoring system
  • Plex server running on my NAS
  • Conbee 2 for managing Zigbee devices (Xiaomi, Hue and OSRAM)
  • UPC Back-UPS to protect against power failure my Microserver, my switch and my NAS.
  • Sonoff POW R2 for managing the swiming pool pump (in progress)
  • NAS Synology
  • ADSL box from Orange.
  • Family phones (iOS and Android)

Automations

You can find in my automations and scripts the following features:

  • Regular Home Assistant backup
  • Monitoring of the availibility of the crtical systems of the house.
  • Monitoring the quality of the internet connexion.
  • Control thru Google Assistant of the Vacuum.
  • Daily routines for cleaning the house with the Vacuum.
  • Alarm management (need rework).
  • Check and notification if lights could be switch off.
  • Send notification in case of weather alert or rain expected.
  • Send notification if I forget to plug the electrical car.
  • Manage the pool pump schedule.
  • And many other things...

Custom components used

To help me I used the following custom components:

(*): integrations update managed with HACS

Integrations configured thru HA GUI

The following integrations are not configured in YAML files. So you won't see it in this repository:

  • Mobile App to integrate family smartphones data.
  • Blitzortung (cf. customs components list).
  • Brother to have a status of my new printer.
  • CO2 Signal
  • deCONZ pour control my Zigbee devices.
  • ESPHome devices integration in HA.
  • IFTTT used for piloting the vacuum robot from the Google Home.
  • Google Cast used for some TTS messages in the house.
  • Météo-France to have weather alerts and rain forecast within the hour.
  • Network UPS Tool (NUT) to monitor my UPC Back-UPS.
  • Livebox (cf. custom components list).
  • Plex to connect my Plex server.
  • Renault to integrate my Zoe data. Kudos to @epenet who has invest a lot of energy with a little support from me to have this official integration.
  • RFXTRX to control my radio devices.
  • SpeedTest to monitor my ISP connexion.
  • Synology to monitor my NAS.
  • Waze to monitor the duration of our commutes.

Addons used

One more thing

I have and will add specific explanations in the wiki. So don't forget to visit it.

Contact me

If you want to discuss with me about my configuration, you can do it through the following tools:

About

Ma configuration Home Assistant commentée en anglais et en français | My Home Assistant config with French and English comments.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published