homebridge-pushover-switches

Plugin Homebridge pour envoyer des notifications Pushover via des switches virtuels HomeKit.
Chaque switch peut utiliser son propre app token Pushover, tout en partageant le même user key.

Installation

Option A — Installation locale (sans publier sur npm)

1. Copie le dossier homebridge-pushover-switches dans le répertoire de ton choix, par exemple :

   /var/lib/homebridge/homebridge-pushover-switches/

2. Installe le plugin en local depuis l'interface Homebridge UI ou en ligne de commande :

   cd /var/lib/homebridge
   npm install ./homebridge-pushover-switches

Option B — Via Homebridge UI (fichier local)

Dans Homebridge UI → Plugins → "Install plugin from path or npm package name"
→ entre le chemin absolu vers le dossier du plugin.

Configuration

Ajoute ceci dans ton fichier config.json Homebridge (section platforms) :

{
  "platforms": [
    {
      "platform": "PushoverSwitches",
      "name": "Pushover Switches",
      "user_key": "TON_USER_KEY_PUSHOVER",
      "switches": [
        {
          "name": "Alarme Maison",
          "app_token": "APP_TOKEN_1",
          "title": "🏠 Alarme",
          "message": "L'alarme maison a été déclenchée !",
          "sound": "siren",
          "priority": 1
        },
        {
          "name": "Notification Portail",
          "app_token": "APP_TOKEN_2",
          "title": "🚪 Portail",
          "message": "Le portail vient de s'ouvrir.",
          "sound": "door",
          "priority": 0
        },
        {
          "name": "Alerte Domotique",
          "app_token": "APP_TOKEN_3",
          "message": "Alerte domotique déclenchée",
          "auto_off_delay": 2
        }
      ]
    }
  ]
}

Paramètres

Plateforme

| Paramètre | Requis | Description | |------------|--------|------------------------------------| | platform | ✅ | Toujours "PushoverSwitches" | | user_key | ✅ | Ton User Key Pushover | | switches | ✅ | Liste des switches (voir ci-dessous) |

Par switch

| Paramètre | Requis | Défaut | Description | |-----------------|--------|---------------------|--------------------------------------------------| | name | ✅ | — | Nom affiché dans HomeKit | | app_token | ✅ | — | App Token Pushover (différent par switch !) | | title | ❌ | Nom du switch | Titre de la notification | | message | ❌ | "<nom> triggered" | Corps de la notification | | sound | ❌ | Son par défaut | Son Pushover (siren, door, magic, etc.) | | priority | ❌ | 0 | -2 (silencieux) à 2 (urgence) | | device | ❌ | Tous | Envoyer à un appareil spécifique | | url | ❌ | — | URL cliquable dans la notification | | url_title | ❌ | — | Texte du lien URL | | auto_off_delay| ❌ | 1 | Délai (secondes) avant remise à OFF. 0 = manuel |

Fonctionnement

• Activer le switch → envoie la notification Pushover → le switch repasse automatiquement à OFF (après auto_off_delay secondes)
• Compatible avec les automatisations HomeKit, Siri, et les apps tierces (Home+, Controller, etc.)

Trouver tes tokens Pushover

1. User Key : visible sur https://pushover.net (tableau de bord, en haut à droite)
2. App Token : crée une application sur https://pushover.net/apps/build — crées-en une par switch pour les différencier