📡 Manuel d'utilisation — Plugin ntfybridge
Suivez le guide de mise en route → : serveur ntfy, exposition HTTPS (sous-domaine ou Tailscale), Chat Famille PWA et premier test en 6 étapes.
Découvrez un exemple concret avec trois utilisateurs et trois salons : domotique, alertes et messagerie familiale → Voir les exemples →
Le plugin ntfybridge connecte Jeedom à ntfy, une application de notifications open-source disponible sur iOS, Android et Web.
La communication est bidirectionnelle :
- Jeedom → Téléphone : alertes, rapports, photos, fichiers
- Téléphone → Jeedom : questions, commandes, confirmations
App ntfy officielle (iOS / Android) — idéale pour les notifications domotiques : alertes, rapports, boutons de confirmation. Légère, sobre, centrée sur le push.
Chat Famille (PWA intégrée au plugin) — messagerie temps réel pour tous les membres du foyer, installable sur l'écran d'accueil comme une vraie app. Salons, fichiers, photos, boutons d'action Jeedom. Aucun compte externe, données chez vous. → voir Chat Famille ↓
Pourquoi ntfybridge ?
La plupart des solutions de notification domotique sont à sens unique : la box envoie une alerte, point final. Pour agir, il faut ouvrir l'app, naviguer, chercher le bon bouton.
ntfybridge inverse la logique. Votre domotique devient une conversation : vous posez une question, Jeedom répond. Vous donnez un ordre, Jeedom demande confirmation. Le tout depuis une simple notification — sans ouvrir Jeedom.
En mode embarqué, ntfy devient aussi une messagerie privée entre les membres du foyer. Chaque utilisateur dispose de son propre accès contrôlé par le panel intégré — pas besoin de WhatsApp, Telegram ou autre service tiers pour se prévenir que le portail est ouvert ou que le dîner est prêt.
Et quand tout plante — Apache en panne, Jeedom inaccessible — le mode secours peut prendre le relais. Le démon tourne indépendamment de PHP et de l'interface web : si l'accès distant à ntfy ne passe pas par Apache (Tailscale, port direct…), un ping ou emergency suffit pour diagnostiquer et relancer les services sans SSH.
Tout reste chez vous : en mode embarqué, ntfy tourne sur votre serveur, aucun intermédiaire pour vos messages. Les notifications Web Push transitent cependant par les services de votre navigateur (APNs pour iOS, FCM pour Android via Firebase) — c'est inhérent au standard Web Push, indépendamment du plugin.
🚀 Démarrage rapide — 9 étapes
Parcours minimal pour avoir un Jeedom joignable par notification depuis votre téléphone, sans créer d'équipement.
| # | Étape | Détail |
|---|---|---|
| 1 | Installer le plugin | Market Jeedom ou GitHub → activer le plugin |
| 2 | Installer les dépendances | Bouton Relancer — installe Node.js ≥ 22 et le binaire ntfy automatiquement |
| 3 | Configurer le serveur ntfy | Mode embarqué : définir l'identifiant admin et le mot de passe → voir détails ↓ |
| 4 | Démarrer le démon | Bouton Relancer — le serveur ntfy démarre avec le démon |
| 5 | Exposer ntfy | Option A — sous-domaine : ouvrir les ports 80/443 sur la box + assistant reverse proxy → voir ↓ · Option B — Tailscale : assistant Tailscale intégré, aucun port à ouvrir → voir ↓ |
| 6 | Tester l'accès | Vérifier que ntfy est joignable depuis l'extérieur (curl ou bouton Tester dans le wizard) |
| 7 | Créer un utilisateur ntfy | Panel utilisateurs : ajouter un compte avec droits sur le topic secours → voir panel ↓ |
| 8 | Installer l'app ntfy | Télécharger sur iOS / Android, ajouter le serveur, s'authentifier → voir app ↓ |
| 9 | Configurer les topics secours et tester le ping | Modale Secours : renseigner le topic action et réponse, activer ping, envoyer ping depuis l'app → voir secours ↓ |
En 9 étapes, votre Jeedom est joignable de n'importe où par notification — même si l'interface web est en panne.
🖥️ Configurer le serveur ntfy
Plugins → Gestion des plugins → ntfybridge → Configuration
- ⭐ Mode embarqué (recommandé)
- Mode externe
Le serveur ntfy est intégré au plugin — tout est automatique.
| Paramètre | Description |
|---|---|
| Port ntfy | Auto-détecté au premier démarrage. Boutons Tester et Auto-détecter disponibles |
| Identifiant admin | Compte administrateur ntfy, généré à l'installation (défaut : ntfyadmin) |
| Interface d'écoute | Localhost (recommandé, derrière reverse proxy) ou LAN (toutes les interfaces) |
| URL publique | URL HTTPS depuis laquelle ntfy est joignable — Internet public (ex: https://ntfy.mondomaine.fr) ou réseau privé (ex: Tailscale https://jeedom.mondomaine.ts.net:8443) |
Pour exposer ntfy sur Internet : renseigner l'URL publique puis cliquer sur Assistant reverse proxy. L'assistant génère la configuration en 5 étapes pour Apache, Nginx, NPM, Traefik ou Cloudflare.
Via Tailscale : si votre Jeedom est accessible sur un réseau Tailscale, renseigner l'URL Tailscale (ex: https://jeedom.mondomaine.ts.net:8443). Aucune ouverture de port Internet n'est nécessaire — le Chat Famille, le push et les boutons de confirmation fonctionnent sur tous vos appareils Tailscale.
- Sauvegarder la configuration → le port est auto-détecté
- Démarrer le démon → le serveur ntfy démarre automatiquement
- (Optionnel) Lancer l'assistant reverse proxy pour l'accès externe
Le plugin se connecte à un serveur ntfy existant (ntfy.sh, auto-hébergé…).
| Paramètre | Description |
|---|---|
| URL du serveur | URL complète : https://ntfy.sh ou https://ntfy.monserveur.fr |
| Nom d'utilisateur | Compte ntfy ayant accès en lecture/écriture aux topics |
| Mot de passe | Mot de passe du compte ntfy |
Cliquer sur Tester la connexion pour valider les identifiants.
En mode externe, la gestion des utilisateurs et des permissions n'est pas disponible dans Jeedom. Vous devez les configurer directement sur votre serveur ntfy.
👥 Gérer les utilisateurs (panel)
Plugins → ntfybridge → Panel
Le panel de gestion des utilisateurs est disponible uniquement en mode embarqué. En mode externe, gérez les utilisateurs directement sur votre serveur ntfy.
Le panel affiche un tableau croisé Topics x Utilisateurs permettant de gérer finement les droits d'accès.
Ajouter un utilisateur
- Cliquer sur Ajouter un utilisateur
- Saisir un nom d'utilisateur et un mot de passe (minimum 8 caractères)
- Cliquer sur Créer
Gérer les permissions
Pour chaque combinaison utilisateur/topic, choisir le niveau d'accès :
| Permission | Description |
|---|---|
| read-write | L'utilisateur peut publier et recevoir les messages sur ce topic |
| read-only | L'utilisateur peut uniquement recevoir les messages |
| deny-all | Accès interdit à ce topic |
Chaque modification est appliquée immédiatement sur le serveur ntfy.
Supprimer un utilisateur
Cliquer sur l'icône de suppression dans la colonne de l'utilisateur. La suppression est définitive.
📱 Installer et configurer l'app ntfy
Télécharger l'app
| Plateforme | Lien |
|---|---|
| iOS | App Store |
| Android | Google Play ou F-Droid |
| Web | Accéder à l'URL de votre serveur ntfy dans un navigateur |
S'abonner à un topic
- Ouvrir l'app ntfy
- Appuyer sur + (ajouter un abonnement)
- Configurer selon votre mode :
- ⭐ Mode embarqué
- Mode externe
- Avec sous-domaine : saisir l'URL complète
https://ntfy.votredomaine.fr/votre_topic - En local / VPN : saisir
http://IP_JEEDOM:PORT_NTFY/votre_topic - Si authentification : renseigner le nom d'utilisateur et le mot de passe créés dans le panel
- ntfy.sh : saisir uniquement le nom du topic (ex:
maison_cmd) - Auto-hébergé : saisir l'URL complète
https://ntfy.monserveur.fr/votre_topic - Si authentification : renseigner vos identifiants ntfy
L'URL d'abonnement est affichée dans la section Abonnement de chaque équipement ntfybridge — vous pouvez la copier directement.
✨ Ce que vous pouvez faire
- 🏠 Jeedom → Téléphone
- 📱 Téléphone → Jeedom
- 💬 Chat Famille
Jeedom vous contacte, vous informe, vous alerte.
- 🔔 Alerte si une fenêtre est ouverte sous la pluie
- 🌡️ Notification si la température du garage descend sous 5 °C
- 📸 Photo de caméra quand le portail s'ouvre
- 🚨 Alerte urgente avec icône et son personnalisé
- 📋 Rapport quotidien de l'état de la maison
- ⏰ Message différé — "Rappel dans 30 minutes"
- 🗂️ Profils d'envoi nommés : urgent, discret, rapport…
Vous interrogez ou pilotez Jeedom par message.
- 💬
température salon→ Jeedom répond avec la valeur en temps réel - 💡
éteins tout→ Jeedom éteint toutes les lumières - 🔒
état alarme→ Jeedom répond armé ou désarmé - ✅ "Confirmer l'ouverture du portail ?" avec boutons Oui ✓ / Non ✗
- 🩺
ping→ Jeedom répond avec son état de santé
Messagerie privée entre membres du foyer — sans app tierce.
Le plugin inclut une application de chat complète, installable sur l'écran d'accueil (PWA). Elle fonctionne sur ntfy embarqué, données 100 % chez vous.
- 🏠 Salons par thème (Famille, Maison, Alertes…)
- 📎 Envoi de photos et fichiers — glisser-déposer, coller depuis le presse-papier
- 🖼️ Visionneuse plein écran pour les images
- 🔔 Notifications push par salon — muet par salon
- 🔴 Pastille de messages non lus sur l'icône de l'écran d'accueil
- 🤖 Les boutons de confirmation Jeedom (Oui ✓ / Non ✗) s'affichent directement dans le chat
- 🚫 Aucun compte WhatsApp, Telegram ou autre service externe
Accessible sur
https://jeedom.votredomaine.fr/plugins/ntfybridge/chat/→ documentation complète ↓
🔀 Modes de configuration
Mode embarqué + sous-domaine HTTPS ou Tailscale — installation all-in-one, données chez vous, toutes les fonctionnalités : push iOS natif, boutons de confirmation, icônes, fichiers joints, Chat Famille PWA.
- Sous-domaine : accès depuis n'importe quel appareil, même hors Tailscale
- Tailscale : aucun port à ouvrir, HTTPS automatique, idéal si pas d'IPv4 fixe
- ⭐ Embarqué + sous-domaine
- ⭐ Embarqué + Tailscale
- Embarqué local
- Externe — ntfy.sh
- Externe — auto-hébergé
ntfy est inclus dans le plugin et exposé via reverse proxy sur un sous-domaine.
Atouts :
- All-in-one, rien à installer séparément
- Toutes les fonctionnalités : push iOS natif, boutons Oui/Non, icônes, fichiers
- Données chez vous, contrôle total des utilisateurs ntfy
- Assistant reverse proxy intégré (5 étapes guidées)
Contraintes :
- Nécessite un nom de domaine (ex:
ntfy.mondomaine.fr) - Nécessite un reverse proxy (Apache, Nginx, NPM, Traefik, Cloudflare…) — voir configuration →
ntfy est inclus et exposé uniquement sur votre réseau Tailscale (VPN mesh P2P). Pas de sous-domaine, pas de port ouvert, HTTPS automatique.
Atouts :
- Zéro port ouvert sur Internet — seuls les appareils dans votre réseau Tailscale ont accès
- HTTPS automatique via les certificats Tailscale (
tailscale serve) — pas de Let's Encrypt, pas de reverse proxy à configurer - Pas de domaine à acheter ni de DNS externe à gérer
- Fonctionne même sans IPv4 fixe ou sans ports entrants (box 4G, CGNAT, FAI qui bloque les ports)
- Toutes les fonctionnalités : push iOS, boutons Oui/Non, Chat Famille — sur tous vos appareils Tailscale
Contraintes :
- Les notifications n'arrivent que sur les appareils avec Tailscale installé (iOS, Android, ordinateurs)
- Si vous souhaitez partager ntfy avec quelqu'un hors de votre réseau Tailscale → préférer le sous-domaine
Usage 100 % familial/personnel sur appareils maîtrisés, pas d'IPv4 fixe, ou FAI qui bloque les ports entrants. C'est la configuration la plus simple et la plus sûre dans ces cas.
Lancer l'Assistant Tailscale depuis la configuration du plugin pour configurer tailscale serve et mettre à jour l'URL en 3 étapes guidées.
ntfy est inclus, accessible uniquement sur le réseau local.
Atouts :
- Zéro configuration réseau externe
- Aucun port ouvert sur Internet
Contraintes :
- Boutons Oui/Non non fonctionnels hors réseau local
- Push iOS natif indisponible sans HTTPS public
Le plugin se connecte au service public ntfy.sh.
Atouts : Aucun serveur à gérer, HTTPS inclus, push iOS fonctionnel.
Contraintes : Quota 250 messages/jour, topics semi-publics, dépendance externe.
Le plugin se connecte à votre propre serveur ntfy (VPS, NAS…).
Atouts : Données chez vous, aucun quota, toutes les fonctionnalités si HTTPS.
Contraintes : Serveur à maintenir, panel utilisateurs désactivé dans Jeedom.
📦 Installation
1️⃣ Installer le plugin
Plugins → Gestion des plugins → Market → ntfybridge → Installer
Activer le plugin après installation.
Node.js (≥ 22) et le binaire ntfy sont installés automatiquement. Aucune intervention manuelle.
2️⃣ Créer un équipement
- Plugins → ntfybridge → Ajouter
- Nommer, activer
- Configurer les topics :
- Topic d'écoute : Jeedom reçoit les messages sur ce topic (ex:
maison_cmd) - Topic de réponse : Jeedom envoie ses réponses sur ce topic (ex:
maison_reply)
- Topic d'écoute : Jeedom reçoit les messages sur ce topic (ex:
- Sauvegarder — les commandes sont créées automatiquement
Le topic est l'équivalent d'un mot de passe. Choisir un nom difficile à deviner.
S'abonner dans l'app ntfy en copiant l'URL affichée dans la section Abonnement de l'équipement.
🗂️ Configuration de l'équipement
Chaque équipement ntfybridge dispose de quatre onglets.
⚙️ Onglet Équipement
📡 Topics
| Champ | Rôle |
|---|---|
| Topic d'écoute | Topic ntfy sur lequel Jeedom reçoit les messages entrants (SSE). Ex: maison_cmd |
| Topic de réponse | Topic ntfy sur lequel Jeedom envoie ses réponses automatiques et confirmations. Ex: maison_reply |
Les deux topics peuvent être identiques si vous n'avez qu'un seul topic pour tout. Séparer les topics permet cependant de s'abonner uniquement aux réponses sans recevoir ses propres commandes en écho.
🔧 Valeurs par défaut
Ces valeurs s'appliquent à chaque envoi si aucune surcharge n'est définie par commande cache ou paramètre inline.
| Paramètre | Description |
|---|---|
| Priorité | Niveau de notification : 1=min (silencieux) · 2=low · 3=défaut · 4=high · 5=urgent (son fort) |
| Tags | Emojis affichés dans la notification, séparés par virgule (ex: loudspeaker,bell) |
| Markdown | Active le rendu gras, italique, listes dans le corps du message |
| Icône | URL d'une image affichée comme icône (Android uniquement) |
| Délai | Envoi différé : 30m, 9am, 2026-01-01T09:00… |
| Cache ntfy | Mise en cache côté serveur ntfy (yes/no). Vide = comportement serveur |
| Firebase | Activation du push Firebase (yes/no). Vide = comportement serveur |
🔒 Sécurité
| Paramètre | Description |
|---|---|
| Utilisateurs autorisés | Liste des utilisateurs ntfy autorisés à envoyer des commandes, séparés par virgule. Vide = tous |
| Mots interdits | Mots dont la présence dans le message bloque tout traitement (ex: delete,rm,sudo) |
| Timeout confirmation | Délai d'expiration d'une demande de confirmation Oui/Non, en secondes (défaut : 60 s) |
🔕 Mode silencieux
| Option | Description |
|---|---|
| Mode silencieux global | Bloque tous les envois et réponses automatiques |
| Désactiver les envois sortants | Bloque définitivement la commande send_message |
| Désactiver les réponses automatiques | Ignore les règles Réponses et Actions pour les messages entrants |
| En mode silencieux | Comportement : bloquer complètement ou passer en priorité 1 (min, silencieux) |
| Plages horaires | Périodes de silence automatique (ex: 22:00 → 08:00) |
Désactiver les envois sortants est utile par exemple pour un équipement dédié uniquement à la réception de commandes, sans jamais envoyer de notification sur le topic d'écoute.
💬 Onglet Réponses
Définit ce que Jeedom répond quand il reçoit un message correspondant à des mots-clés.
📋 Colonnes de la règle
| Champ | Description |
|---|---|
| Nom | Libellé de la règle (affiché dans le select Déclencher réponse) |
| Mots-clés | Termes déclencheurs, s éparés par virgule. Ex: température salon, temp salon |
| Mode | Contient : le mot-clé peut être dans un mot plus long · Mot exact : doit être un mot séparé (évite les faux positifs) |
| Réponse | Texte envoyé, avec références {#id_commande#} pour insérer des valeurs en temps réel |
| Titre | Titre de la notification ntfy (optionnel) |
| Priorité | Priorité de la réponse (1–5) |
| Tags | Emojis ntfy pour la réponse |
| Image URL | URL d'une image attachée à la réponse |
🔗 Références de commandes dans la réponse
Cliquer sur + pour ouvrir le sélecteur de commandes Jeedom et insérer {#id#} à la position du curseur.
Salon : {#364#} °C — Humidité : {#365#} % — CO₂ : {#366#} ppm
Plusieurs commandes peuvent être combinées dans le même template. Les valeurs sont lues en parallèle au moment de l'envoi.
Chaque règle peut envoyer la réponse sur un topic différent du topic de réponse par défaut de l'équipement (champ Topic de réponse optionnel par règle).
⚡ Onglet Actions
Définit ce que Jeedom exécute quand il reçoit un message correspondant à des mots-clés.
📋 Champs de la règle
| Champ | Description |
|---|---|
| Nom | Libellé de la règle (affiché dans le select Déclencher action) |
| Mots-clés | Termes déclencheurs, séparés par virgule |
| Mode | Contient ou Mot exact (voir Onglet Réponses) |
| Action | Commande ou scénario Jeedom à exécuter (sélecteur standard Jeedom) |
| Confirmation | Si activé : envoie une notification avec boutons Oui ✓ / Non ✗ avant d'exécuter |
| Texte de confirmation | Message affiché avec les boutons (ex: Ouvrir le portail ?) |
| Texte succès | Message envoyé après exécution réussie |
| Texte annulation | Message envoyé si l'utilisateur clique Non |
| Priorité / Tags | Paramètres ntfy de la notification de confirmation |
✅ Confirmation Oui / Non
Quand la confirmation est activée, Jeedom génère un token sécurisé (128 bits, usage unique) et envoie une notification ntfy avec deux boutons HTTP.
- Oui ✓ → Jeedom exécute l'action et envoie le texte succès
- Non ✗ → Jeedom envoie le texte annulation et supprime le token
Le token expire automatiquement après le timeout configuré (onglet Équipement → Sécurité).
Les boutons ntfy s'affichent dans le détail du message (tap sur la notification), pas en bandeau sur l'écran verrouillé. Les boutons nécessitent que l'URL externe Jeedom soit accessible depuis Internet.
Si vous ne souhaitez pas recevoir les messages de confirmation/succès/annulation sur le topic de réponse, laisser les champs Texte succès et Texte annulation vides, et désactiver la confirmation. Seule l'exécution de l'action aura lieu, sans retour ntfy.
🎛️ Onglet Commandes
Les commandes sont créées automatiquement à la sauvegarde de l'équipement. Aucune action manuelle requise.
📤 Commandes d'envoi
| Commande | Type | Rôle |
|---|---|---|
| Envoyer message | Action / message | Déclenche l'envoi réel. Titre + corps. |
| Priorité | Action / slider (1–5) | Définit la priorité du prochain envoi (stocké en cache) |
| Tags | Action / string | Définit les tags du prochain envoi |
| URL | Action / string | Définit l'URL de clic du prochain envoi |
| Image | Action / string | Définit l'URL d'image attachée |
| Fichier | Action / string | Chemin d'un fichier local à envoyer en pièce jointe (PUT binaire) |
| Topic | Action / string | Surcharge ponctuelle du topic d'envoi |
| Markdown | Action / slider (0/1) | Active ou désactive le rendu Markdown |
| Icône | Action / string | URL d'icône pour la notification |
| Délai | Action / string | Envoi différé (30m, 9am…) |
| Cache ntfy | Action / string | Surcharge du cache ntfy (yes/no) |
| Firebase | Action / string | Surcharge Firebase (yes/no) |
🔁 Commandes de déclenchement
| Commande | Type | Rôle |
|---|---|---|
| Déclencher réponse | Action / select | Exécute une règle Réponse depuis un scénario Jeedom |
| Déclencher action | Action / select | Exécute une règle Action depuis un scénario Jeedom |
Les commandes de cache (Priorité, Tags, Icône…) doivent être appelées avant Envoyer message dans le scénario. La commande Envoyer message lit les caches, envoie la notification, puis réinitialise tous les caches.
Bloc action :
1. [Maison][ntfybridge] Priorité → 5
2. [Maison][ntfybridge] Tags → warning,fire
3. [Maison][ntfybridge] Envoyer message
Titre : Alarme
Message : Mouvement détecté zone A
📤 Envoyer des notifications
La commande send_message
Dans un scénario Jeedom :
Action → Message → [équipement ntfybridge] Envoyer message
Titre : Alarme
Message : Mouvement détecté zone A
⚙️ Options d'envoi
Appeler les commandes de cache avant send_message, ou utiliser les paramètres inline directement dans le message :
| Option | Commande cache | Inline | Valeurs |
|---|---|---|---|
| Priorité | send_priority (1–5) | [priority=5] | 1=min · 2=low · 3=défaut · 4=high · 5=urgent |
| Tags | send_tags | [tags=warning,bell] | emojis ntfy séparés par virgule |
| Icône | send_icon | [icon=https://...] | URL image (Android uniquement) |
| Markdown | send_markdown (0/1) | [md=1] | gras, italique, listes |
| Délai | send_delay | [delay=30m] | 30m, 9am, 2026-01-01T09:00 |
| Fichier | send_file | [file=/chemin] | chemin absolu sur le serveur |
| Topic | send_topic | [topic=alertes] | surcharge ponctuelle |
| URL clic | send_url | [url=https://...] | URL ouverte au tap |
Exemple complet avec inline :
[priority=5][tags=warning,fire][title=Alerte] Mouvement détecté zone A
| Fonctionnalité | Android | iOS | Web |
|---|---|---|---|
| Icônes personnalisées | ✅ | ❌ | ✅ |
| Markdown | ✅ | ⚠️ partiel | ✅ |
| Boutons d'action | ✅ | ✅ | ✅ |
| Fichiers joints | ✅ | ✅ | ✅ |
| Push natif sans HTTPS public | Firebase | ❌ | — |
🗂️ Profils d'envoi
Groupez vos paramètres récurrents en profils nommés. Ouvrir depuis Plugins → ntfybridge → Profils.
📊 Niveaux de priorité
| Niveau | Valeur | Comportement |
|---|---|---|
| min | 1 | Silencieux, sans son ni vibration — rapports passifs |
| low | 2 | Discret — bannière silencieuse |
| default | 3 | Comportement standard de l'appareil |
| high | 4 | Son + vibration prioritaire — comportement exact dépendant de l'application ntfy et des autorisations système |
| urgent | 5 | Son fort + vibration maximale — peut être limité par le mode « Ne pas déranger » selon l'OS et les permissions accordées à l'app |
🏷️ Tags courants
Les tags correspondent aux noms d'emojis ntfy, séparés par virgule.
| Tag | Emoji | Usage |
|---|---|---|
warning | ⚠️ | Alerte générale |
rotating_light | 🚨 | Urgence, alarme |
fire | 🔥 | Incendie, température critique |
bell | 🔔 | Notification, rappel |
information_source | ℹ️ | Information, rapport |
white_check_mark | ✅ | Succès, confirmation |
x | ❌ | Erreur, échec |
house | 🏠 | Domotique générale |
thermometer | 🌡️ | Température |
lock | 🔒 | Sécurité, alarme |
droplet | 💧 | Eau, pluie, humidité |
electric_plug | 🔌 | Énergie, coupure |
camera | 📷 | Caméra, détection |
zzz | 💤 | Mode nuit, silence |
➕ Créer un profil
| Champ | Exemple |
|---|---|
| Nom | alerte |
| Priorité | 5 |
| Tags | warning,rotating_light |
| Icône | https://... |
| Markdown | ✅ |
🚀 Utiliser un profil
[profile=alerte] Intrusion détectée
[profile=info] Rapport journalier prêt
[profile=alerte][priority=3] Priorité surchargée par dessus le profil
💬 Règles de réponse
Quand un message entrant correspond à des mots-clés, Jeedom lit une commande info et répond.
Exemple :
- Mots-clés :
température salon, temp salon - Réponse :
Température salon : {#364#} °C — Humidité : {#365#} %
Cliquer sur + dans le champ réponse pour insérer une référence {#id#} via le sélecteur de commandes Jeedom. Plusieurs commandes peuvent être combinées dans le même template.
⚡ Règles d'action
Quand un message correspond, Jeedom exécute une action.
Sans confirmation → action immédiate + message de succès.
Avec confirmation → Jeedom envoie une notification avec boutons Oui ✓ / Non ✗. Le token expire après le délai configuré (défaut : 60 s).
Les boutons ntfy s'affichent dans le détail du message (appui long ou tap sur la notification), pas en bandeau.
🔕 Mode silencieux
Par équipement :
- Mode silencieux global : bloque tous les envois
- Désactiver envois sortants : bloque
send_message - Désactiver réponses automatiques : ignore les règles
- Plages horaires : ex. silencieux de 22 h à 8 h
- Comportement : bloquer complètement ou passer en priorité minimale (1)
🚨 Mode Secours
Le Mode Secours permet d'interroger et de dépanner Jeedom depuis l'application ntfy, même quand l'interface web est inaccessible (Apache ou PHP en panne, Jeedom qui ne répond plus).
Le démon ntfybridge tourne indépendamment de PHP et de l'interface web Jeedom. Les commandes texte (ping, log…) fonctionnent tant que le démon est en vie et que la connexion ntfy est accessible.
Si l'accès distant à ntfy passe par le même Apache que Jeedom (reverse proxy sur la même machine), une panne Apache coupe aussi la connexion ntfy distante. Le mode secours est pleinement efficace quand ntfy est joignable par un chemin indépendant (port direct, Tailscale, autre machine).
Les boutons HTTP de confirmation (Oui/Non) font appel à PHP via ntfybridge.inc.php — ils nécessitent donc que PHP soit opérationnel. Les commandes texte simples (ping, health, log…) n'ont pas cette dépendance.
⚙️ Configurer le Mode Secours
Ouvrir la configuration du plugin :
Plugins → ntfybridge → (icône secours)
📡 Topics secours
| Champ | Description |
|---|---|
| Topic action | Topic ntfy sur lequel vous envoyez vos commandes de secours. Ex: maison_rescue |
| Topic réponse | Topic sur lequel Jeedom vous répond. Peut être différent pour mieux organiser vos abonnements ntfy. |
Séparer le topic secours de vos topics habituels permet de s'y abonner uniquement quand vous en avez besoin — sans polluer vos notifications normales.
🛠️ Commandes natives
Ces commandes sont disponibles sans aucune configuration supplémentaire, même si PHP est inaccessible.
Envoyez le mot-clé dans ntfy → Jeedom répond automatiquement.
| Commande | Ce que vous recevez |
|---|---|
ping | Confirmation de vie + heure du serveur, charge CPU, RAM libre, uptime, résolution DNS Jeedom |
health | État complet : CPU, RAM, espace disque, température, uptime |
log ntfybridged | Les 20 dernières lignes du log du démon ntfybridge |
log <nom_log> | Les 20 dernières lignes de n'importe quel log Jeedom |
jeedom | Rapport de santé Jeedom : base de données, plugins, services |
emergency | Diagnostic Apache, PHP-FPM et MySQL — avec boutons Redémarrer pour chaque service en panne |
Cocher les commandes à activer dans la modale Secours. Il est recommandé d'activer au minimum ping et emergency.
🔴 La commande emergency en détail
Quand vous envoyez emergency :
- Jeedom vérifie l'état d'Apache, PHP-FPM et MySQL
- Pour chaque service en panne, vous recevez une notification ntfy avec deux boutons : Oui ✓ (redémarrer) et Non ✗ (ignorer)
- Si vous appuyez sur Oui, le service redémarre et vous recevez un accusé de réception
Si tous les services sont opérationnels, vous recevez simplement un message "tout va bien".
Pour que le redémarrage des services fonctionne, les droits sudo doivent être accordés à l'utilisateur www-data. La modale Secours affiche exactement le bloc de configuration à copier dans /etc/sudoers.d/ntfybridge.
✏️ Commandes personnalisées
Vous pouvez ajouter vos propres commandes : envoyer un mot-clé dans ntfy déclenche l'exécution d'un script sur le serveur, et le résultat vous est renvoyé.
➕ Ajouter une commande
- Ouvrir la modale Secours
- Cliquer Ajouter une commande
- Remplir :
| Champ | Description |
|---|---|
| Nom | Libellé affiché (ex: Espace disque) |
| Mots-clés | Ce que vous tapez dans ntfy pour déclencher la commande (ex: espace disque, disk) |
| Script | Fichier à exécuter, sélectionné parmi les scripts disponibles dans data/rescue_scripts/. L'interpréteur est déduit automatiquement de l'extension (.sh→bash, .py→python3, .php→php, .js→node) |
| Confirmation | Si activé : Jeedom vous demande Oui/Non avant d'exécuter |
| Timeout | Délai maximum d'exécution en secondes (5–120 s) |
- Cliquer Sauvegarder
📁 Déposer un script
Les scripts doivent être placés dans :
plugins/ntfybridge/data/rescue_scripts/
Formats acceptés : .sh, .php, .js, .py
Le script s'exécute et sa sortie (stdout) est envoyée comme réponse ntfy. En cas d'erreur ou de timeout, vous recevez un message d'erreur sans que le démon ne soit affecté.
Le dossier contient déjà quatre scripts de test (test_hello.sh, test_hello.php, test_hello.js, test_hello.py) qui renvoient simplement la date et la version du langage — pratique pour vérifier que l'exécution fonctionne avant d'ajouter vos propres scripts.
- Seuls les fichiers avec une extension
.sh,.php,.jsou.pysont acceptés - Les noms de fichiers suspects (tentatives de traversée de répertoire) sont automatiquement rejetés
- L'accès est contrôlé par les ACL ntfy configurées dans le panel utilisateurs
📱 Pilotage depuis le téléphone
🍎 iOS — Raccourcis natifs
- App Raccourcis → Nouveau raccourci
- Ajouter l'action Demander du texte (invite facultative)
- Ajouter l'action Obtenir le contenu de l'URL
- URL :
https://ntfy.votredomaine.fr/mon_topic - Méthode :
POST - Corps de la requête : Texte fourni par l'étape précédente
- URL :
- Ajouter le raccourci sur l'écran d'accueil ou l'utiliser avec Siri
Ne pas renseigner de question dans l'action "Demander du texte". Selon la version d'iOS, une invite obligatoire peut être envoyée avec le message et fausser la correspondance des mots-clés dans ntfybridge.
ntfybridge est né de ce concept : un raccourci iOS envoie un POST → Jeedom reçoit et agit.
🤖 Android
| Application | Points forts |
|---|---|
| HTTP Request Shortcuts (F-Droid) | Simple, widget, open-source |
| Tasker | Très puissant, automatisations avancées |
| MacroDroid | Accessible, actions HTTP intégrées |
📄 Logs
| Log | Description |
|---|---|
ntfybridge | Log principal du plugin et du démon |
Activer Debug uniquement pour le diagnostic.
🌐 Configurer le reverse proxy (mode embarqué + sous-domaine)
L'assistant intégré génère la configuration Apache en 5 étapes.
Appliquer ensuite dans le terminal :
sudo nano /etc/apache2/sites-available/ntfy.conf
# Coller le contenu généré par le wizard
sudo apt install certbot python3-certbot-apache -y
sudo a2ensite ntfy.conf
sudo a2enmod proxy proxy_http proxy_wstunnel rewrite ssl headers
sudo apache2ctl configtest
sudo systemctl reload apache2
sudo certbot --apache -d ntfy.votredomaine.fr
curl -I https://ntfy.votredomaine.fr
# Attendu : HTTP/2 200 (ou 401 si auth — normal ✅)
Retourner dans le wizard → Suivant → validation finale.
sudo certbot renew --dry-run
💬 Chat Famille
Le Chat Famille est une messagerie privée PWA incluse dans le plugin, construite sur ntfy. Elle permet aux membres du foyer de s'envoyer des messages et des fichiers depuis n'importe quel appareil — sans WhatsApp, Telegram ou autre service tiers.
https://jeedom.votredomaine.fr/plugins/ntfybridge/chat/
Le Chat Famille est hébergé par Jeedom et se connecte à un serveur ntfy en HTTPS. Il fonctionne avec le serveur embarqué (sous-domaine, Tailscale…) ou avec un serveur ntfy externe auto-hébergé. Le push et l'authentification doivent être configurés sur le serveur ntfy utilisé.
📋 Prérequis
| Condition | Détail |
|---|---|
| HTTPS obligatoire | Le Service Worker (PWA, push) ne fonctionne qu'en HTTPS |
| Web Push activé | Activé par défaut dans le binaire ntfy embarqué (enable_web_push: true) |
| URL externe ntfy configurée | Dans la configuration du plugin — pré-remplit le champ serveur à la connexion |
| Compte utilisateur ntfy | Créer un compte dans le panel utilisateurs avec droits read-write sur le topic du salon |
| iOS : PWA installée | Sur iPhone, les notifications push ne fonctionnent qu'en mode PWA — ajouter le chat à l'écran d'accueil |
Si Jeedom applique une CSP stricte (security.conf), ajouter les directives Header dans le .htaccess du chat pour autoriser les connexions vers le serveur ntfy externe. L'assistant reverse proxy génère la configuration complète.
📱 Installer l'app (PWA)
- 🍎 iOS
- 🤖 Android
- 🌐 Web
- Ouvrir
https://jeedom.votredomaine.fr/plugins/ntfybridge/chat/dans Safari - Appuyer sur Partager → Sur l'écran d'accueil
- Nommer l'app (ex: Famille) → Ajouter
- Ouvrir depuis l'icône sur l'écran d'accueil
Les notifications push ne fonctionnent que depuis l'icône de l'écran d'accueil, pas depuis Safari directement.
- Ouvrir
https://jeedom.votredomaine.fr/plugins/ntfybridge/chat/dans Chrome - Menu ⋮ → Installer l'application (ou bannière automatique)
- L'app apparaît dans le tiroir d'applications
Ouvrir https://jeedom.votredomaine.fr/plugins/ntfybridge/chat/ dans n'importe quel navigateur. Toutes les fonctionnalités sont disponibles sauf le push sur iOS non-PWA.
🔑 Connexion
Au premier lancement, renseigner :
| Champ | Valeur |
|---|---|
| Serveur | Pré-rempli automatiquement depuis la config Jeedom (ex: https://ntfy.votredomaine.fr) |
| Utilisateur | Compte ntfy créé dans le panel |
| Mot de passe ou token | Mot de passe du compte, ou token ntfy (tk_…) |
Les identifiants sont conservés localement pour la reconnexion automatique. Pour les modifier, ouvrir Réglages → Serveur / Utilisateur / Mot de passe.
🏠 Salons
Chaque salon correspond à un topic ntfy. L'utilisateur doit avoir les droits read-write sur ce topic.
Ajouter un salon
- Appuyer sur + dans la barre de salons
- Saisir un nom affiché et un topic ntfy (lettres, chiffres,
-et_, 1–64 caractères) - Valider — le salon apparaît dans la liste
Options d'un salon (menu ⋯)
| Option | Description |
|---|---|
| Renommer | Modifier le nom affiché (le topic ntfy ne change pas) |
| Notifications | Activer ou désactiver les notifications push pour ce salon |
| Effacer mes messages | Efface l'historique local (ne supprime pas les messages du serveur) |
| Retirer ce salon | Supprime le salon localement et désabonne du push |
💬 Messagerie
- Envoi texte : Enter pour envoyer, Shift+Enter pour un saut de ligne
- Envoi de fichiers : bouton trombone, coller depuis le presse-papier (Ctrl+V / ⌘V), ou glisser-déposer dans la zone de messages
- Temps réel : WebSocket multi-salons avec reconnexion automatique
- Historique : 500 messages conservés localement par salon
- Brouillons : le brouillon de chaque salon est conservé si vous changez de salon
Affichage des messages
- Messages Moi (bulles à droite) vs autres (bulles à gauche) vs système (alertes Jeedom, notifications)
- Avatars colorés avec initiales — couleur déterministe par nom d'expéditeur
- Emojis seuls affichés en grand
- Images cliquables → visionneuse plein écran (swipe bas pour fermer sur mobile)
- Fichiers non-image → lien de téléchargement
- Boutons d'action ntfy : jusqu'à 3 boutons par message (
view,http) — les boutons de confirmation Jeedom (Oui ✓ / Non ✗) apparaissent ici
🔔 Notifications push
Le push repose sur les clés VAPID générées par le plugin (ntfy webpush keys) et la configuration du serveur ntfy. Il doit être activé côté serveur (enable_web_push: true, visible dans /config.js du serveur ntfy).
- Ouvrir Réglages (icône ⚙) → activer Notifications (global d'abord)
- Autoriser les notifications dans le navigateur
- Activer/désactiver par salon depuis le menu ⋯ de chaque salon
- Les notifications arrivent même application fermée
| Comportement | Détail |
|---|---|
| Vos propres messages | Jamais notifiés |
| Salon muet | Pas de push pour ce salon (icône cloche barrée dans la liste) |
| Clic sur notification | Ouvre directement le bon salon, même si l'app est fermée |
| Expiration d'abonnement | Notification de rappel après ~7 jours d'inactivité (ntfy 2.11.0) — ouvrir l'app pour renouveler. La valeur exacte dépend de la version du serveur ntfy embarqué. |
⚙️ Réglages
Appuyer sur l'icône ⚙ pour accéder aux réglages :
| Option | Description |
|---|---|
| Serveur | URL du serveur ntfy — modifiable si vous changez de serveur |
| Utilisateur | Nom d'utilisateur ntfy |
| Mot de passe ou token | Laisser vide pour ne pas modifier ; changer pour mettre à jour les identifiants |
| Notifications | Activer/désactiver le push global |
| Se déconnecter | Purge les données locales et désabonne du push |
⚠️ Limites connues
- Historique non persistant sur le serveur : le cache ntfy embarqué expire après 12 h par défaut — un message non récupéré avant expiration est perdu
- Salons locaux uniquement : les salons ajoutés et renommés ne se synchronisent pas entre appareils
- Identité non vérifiée : le nom affiché correspond au champ
titledes messages ntfy — tout utilisateur autorisé sur le topic peut publier sous n'importe quel nom - Pas d'édition/suppression : ntfy ne supporte pas la modification d'un message envoyé
- Messages système non filtrables : les alertes Jeedom reçues sur un topic de salon s'affichent comme messages système
🔍 Dépannage
❌ Le démon ne démarre pas
- Vérifier Node.js ≥ 22 :
node --version - Port ntfy libre : bouton Reset port dans la configuration
- Consulter les logs : Plugins → ntfybridge → Logs
❌ Les boutons Oui/Non ne fonctionnent pas
L'URL externe Jeedom doit être accessible depuis Internet :
Configuration → Général → URL d'accès externe
🔕 Aucune notification reçue
- Topic identique dans l'équipement et l'app ntfy
- Utilisateur autorisé (
allowedUsers) - Pas de mot interdit déclenché (
blacklistWords)
🍎 Push iOS absent
Nécessite un sous-domaine HTTPS en mode embarqué, ou ntfy.sh en mode externe.