WatchYourLAN Home Assistant Integration

Description

Cette intégration personnalisée permet d'ajouter les appareils détectés par l'application WatchYourLAN à Home Assistant en tant que device_tracker. Elle inclut également un capteur binaire indiquant si l'API WatchYourLAN est accessible.

Fonctionnalités

• Device Tracker : Suivi des appareils connectés sur votre réseau local.
  • Affiche les informations suivantes :
    • Adresse MAC
    • Adresse IP
    • Nom de l'appareil (si disponible)
    • Statut de connexion (Now)
    • Appareil approuvé (Known)
  • Mise à jour dynamique des appareils en temps réel.
• Binary Sensor : Indique si l'API WatchYourLAN est joignable.
  • Icône dynamique : mdi:lan-connect ou mdi:lan-disconnect.

Prérequis

• Serveur WatchYourLAN fonctionnant sur votre réseau local.
• Home Assistant installé et configuré.

Installation

Étape 1 : Télécharger les fichiers

1. Clonez ou téléchargez ce dépôt GitHub.
2. Copiez le dossier custom_components/watchyourlan dans le répertoire config/custom_components de votre installation Home Assistant.

Étape 2 : Redémarrer Home Assistant

Redémarrez Home Assistant pour que l'intégration soit détectée.

Étape 3 : Ajouter l'intégration

1. Accédez à Paramètres > Appareils et services.
2. Cliquez sur "Ajouter une intégration".
3. Recherchez "WatchYourLAN" et suivez les étapes de configuration.
   • Saisissez l'adresse IP et le port du serveur WatchYourLAN.

Configuration

Options disponibles

Après avoir ajouté l'intégration, vous pouvez configurer :

• Intervalle de scan : Période entre chaque mise à jour des données (par défaut : 60 secondes).

Exemple de configuration YAML (facultatif)

Si vous souhaitez activer les logs de débogage, ajoutez ceci dans votre fichier configuration.yaml :

logger:
  default: info
  logs:
    custom_components.watchyourlan: debug

Problèmes courants

1. Aucun appareil détecté :
   • Vérifiez que le serveur WatchYourLAN est actif et accessible via l'API.
   • Assurez-vous que les appareils sont marqués comme "Known" dans WatchYourLAN.
2. Erreur de connexion :
   • Vérifiez que l'adresse IP et le port sont corrects.
   • Confirmez que le serveur WatchYourLAN est accessible depuis Home Assistant.

Contribuer

Les contributions sont les bienvenues ! Si vous trouvez un bug ou souhaitez ajouter une fonctionnalité, ouvrez une issue ou soumettez une pull request.

Ressources

• Documentation officielle de WatchYourLAN
• Home Assistant Developer Docs