ntfybridge

Communication bidirectionnelle entre Jeedom et ntfy. Recevez des alertes riches et pilotez votre domotique par message depuis votre téléphone.

Jeedom 4.4+betaos 11+php 7.4/8.xNode.js☕ Soutenir le développement

📡 Manuel d'utilisation — Plugin ntfybridge

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

✨ Ce que vous pouvez faire

🏠 Jeedom → Téléphone
📱 Téléphone → Jeedom

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é

🔀 Modes de configuration

Configuration recommandée

Mode embarqué + sous-domaine HTTPS — installation all-in-one, données chez vous, toutes les fonctionnalités (push iOS natif, boutons de confirmation, icônes, fichiers joints).

⭐ Embarqué + sous-domaine
Embarqué local / VPN
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 →

📦 Installation

1️⃣ Installer le plugin

Plugins → Gestion des plugins → Market → ntfybridge → Installer

Activer le plugin après installation.

info

Node.js (≥ 18) 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)
Sauvegarder — les commandes sont créées automatiquement

astuce

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`

astuce

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)

info

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.

Exemple de template multi-commandes
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.

info

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é).

attention

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.

Désactiver les notifications sur le topic d'action

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

Ordre d'exécution dans un scénario

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.

Exemple de scénario Jeedom
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

Compatibilité plateformes

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, même en mode ne pas déranger
urgent	`5`	Son fort + vibration + contourne le mode silencieux

🏷️ 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).

attention

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 Jeedom. Il peut donc continuer à répondre à vos messages même quand tout le reste est KO.

⚙️ 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.

astuce

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
`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".

Droits sudo nécessaires

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/`
Type	Langage du script : `sh` (bash), `php`, `node`, `py` (Python)
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é.

Scripts de test fournis

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.

Sécurité

Seuls les fichiers avec une extension .sh, .php, .js ou .py sont 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
Ajouter le raccourci sur l'écran d'accueil ou l'utiliser avec Siri

Invite facultative

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.

L'idée d'origine

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 :

Étape 1 — Créer le fichier de config
sudo nano /etc/apache2/sites-available/ntfy.conf
# Coller le contenu généré par le wizard

Étape 2 — Certbot (si pas encore installé)
sudo apt install certbot python3-certbot-apache -y

Étape 3 — Activer et obtenir le certificat SSL
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

Étape 4 — Vérifier
curl -I https://ntfy.votredomaine.fr
# Attendu : HTTP/2 200 (ou 401 si auth — normal ✅)

Retourner dans le wizard → Suivant → validation finale.

Renouvellement SSL automatique

sudo certbot renew --dry-run

🔍 Dépannage

❌ Le démon ne démarre pas

Vérifier Node.js ≥ 18 : 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.

ntfybridge

✨ Ce que vous pouvez faire

🔀 Modes de configuration

📦 Installation

1️⃣ Installer le plugin​

2️⃣ Créer un équipement​

🗂️ Configuration de l'équipement

⚙️ Onglet Équipement​

📡 Topics​

🔧 Valeurs par défaut​

🔒 Sécurité​

🔕 Mode silencieux​

💬 Onglet Réponses​

📋 Colonnes de la règle​

🔗 Références de commandes dans la réponse​

⚡ Onglet Actions​

📋 Champs de la règle​

✅ Confirmation Oui / Non​

🎛️ Onglet Commandes​

📤 Commandes d'envoi​

🔁 Commandes de déclenchement​

📤 Envoyer des notifications

La commande send_message​

⚙️ Options d'envoi​

🗂️ Profils d'envoi

📊 Niveaux de priorité​

🏷️ Tags courants​

➕ Créer un profil​

🚀 Utiliser un profil​

💬 Règles de réponse

⚡ Règles d'action

🔕 Mode silencieux

🚨 Mode Secours

⚙️ Configurer le Mode Secours​

📡 Topics secours​

🛠️ Commandes natives​

🔴 La commande emergency en détail​

✏️ Commandes personnalisées​

➕ Ajouter une commande​

📁 Déposer un script​

📱 Pilotage depuis le téléphone

🍎 iOS — Raccourcis natifs​

🤖 Android​

📄 Logs

🌐 Configurer le reverse proxy (mode embarqué + sous-domaine)

🔍 Dépannage

❌ Le démon ne démarre pas​

❌ Les boutons Oui/Non ne fonctionnent pas​

🔕 Aucune notification reçue​

🍎 Push iOS absent​

1️⃣ Installer le plugin

2️⃣ Créer un équipement

⚙️ Onglet Équipement

📡 Topics

🔧 Valeurs par défaut

🔒 Sécurité

🔕 Mode silencieux

💬 Onglet Réponses

📋 Colonnes de la règle

🔗 Références de commandes dans la réponse

⚡ Onglet Actions

📋 Champs de la règle

✅ Confirmation Oui / Non

🎛️ Onglet Commandes

📤 Commandes d'envoi

🔁 Commandes de déclenchement

La commande send_message

⚙️ Options d'envoi

📊 Niveaux de priorité

🏷️ Tags courants

➕ Créer un profil

🚀 Utiliser un profil

⚙️ Configurer le Mode Secours

📡 Topics secours

🛠️ Commandes natives

🔴 La commande `emergency` en détail

✏️ Commandes personnalisées

➕ Ajouter une commande

📁 Déposer un script

🍎 iOS — Raccourcis natifs

🤖 Android

❌ Le démon ne démarre pas

❌ Les boutons Oui/Non ne fonctionnent pas

🔕 Aucune notification reçue

🍎 Push iOS absent