Intégration domotique Memos, gratuite et open source
Memos dans Gladys : écrire des mémos depuis les scènes, voir les derniers, réagir à un nouveau.
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.2.0
- ★ 0
Connectez Gladys à Memos, l'application libre et auto-hébergée de prise de notes : écrivez des mémos depuis vos scènes (journal de la maison, rappel), affichez les derniers sur le tableau de bord, et lancez une scène quand un mémo portant une étiquette choisie est écrit. Gladys parle directement à votre serveur Memos, sur votre réseau ou sur Internet.
Testée contre un vrai serveur Memos 0.31.0 (l'image Docker officielle,
neosmemo/memos:stable, octobre 2026). L'API de Memos a beaucoup changé d'une
version à l'autre : les serveurs plus anciens ne sont pas pris en charge. Vos
retours sont les bienvenus sur le forum de Gladys.
Prérequis
- Gladys Assistant 5.2 ou plus récent.
- Un serveur Memos 0.31 ou plus récent, joignable depuis la machine Gladys : sur le port 5230 par défaut, ou derrière un proxy inverse.
- Un jeton d'accès : dans Memos, ouvrez Paramètres → Jetons d'accès et créez-en un (choisissez l'expiration Jamais, ou pensez à le renouveler). L'intégration lit et écrit au nom de l'utilisateur à qui appartient le jeton.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Dans Adresse de Memos, saisissez l'adresse IP du serveur, par exemple
192.168.1.50: l'intégration utilise alors le port 5230. Ajoutez le port s'il est différent (192.168.1.50:5231). Derrière un proxy inverse, saisissez l'adresse complète (https://memos.example.org). - Collez le Jeton d'accès (il commence par
memos_pat_). - Lire Memos toutes les : 1, 5 (par défaut), 15, 30 ou 60 minutes. Les nouveaux mémos sont signalés aux scènes à la lecture suivante.
- Langue des noms et des messages fixe le nom des fonctionnalités (figé à l'ajout de l'appareil) et les textes de l'intégration. Français par défaut.
- Enregistrez, puis utilisez Tester la connexion : elle affiche la version de Memos, l'utilisateur et le nombre de mémos.
- Dans l'onglet Découverte, ajoutez l'appareil Memos.
Appareil
Memos (un appareil pour le serveur, au nom du propriétaire du jeton) :
| Fonctionnalité | Valeur |
|---|---|
| Mémos | nombre de vos mémos (hors archivés) |
| Mémos épinglés | nombre de vos mémos épinglés |
| Étiquettes | nombre de vos étiquettes de premier niveau (#maison/garage compte pour maison) |
| Mémos avec tâches à faire | vos mémos qui contiennent une tâche non cochée (- [ ]) |
| Dernier mémo | première ligne du mémo le plus récent que vous pouvez lire, ou « Aucun » |
Les compteurs gardent leur historique. Le badge de l'appareil indique si Memos répond : local pour une adresse de votre réseau, cloud pour un hôte public, injoignable quand il ne répond pas.
Widget du tableau de bord
Memos : trois tuiles (mémos, épinglés, à faire), les six mémos les plus
récents et un bouton Nouveau mémo. Dans les réglages du widget,
Étiquette n'affiche que les mémos d'une étiquette (et de ses
sous-étiquettes), et Mémos épinglés seulement ne garde que les épinglés.
Touchez un mémo pour le lire en entier ; Ouvrir dans Memos apparaît quand
Memos est joint en https. Nouveau mémo ouvre un formulaire : saisissez le
texte (le Markdown et les #étiquettes marchent comme dans Memos) et
l'intégration écrit un mémo privé. Sur un widget réglé sur une étiquette, le
mémo reçoit cette étiquette : un widget courses devient une liste de courses.
Déclencheurs de scène
- Nouveau mémo : un mémo est écrit dans Memos, par vous, ou par un autre utilisateur quand il est partagé avec vous (protégé ou public). Filtres : Auteur (un nom d'utilisateur Memos) et Visibilité.
- Nouveau mémo avec une étiquette : un nouveau mémo porte l'étiquette, ou
une de ses sous-étiquettes (
maisonvaut aussi pour#maison/garage). Saisissez l'étiquette sans#, exactement comme dans Memos : les majuscules comptent. La variable Étiquette trouvée dit laquelle.
Variables des deux : Texte du mémo, Première ligne, Étiquettes
(séparées par des virgules), Auteur (nom d'utilisateur), Visibilité
(private, protected ou public), Visibilité, en toutes lettres et
Lien vers le mémo.
La première lecture après l'installation est silencieuse : les mémos déjà présents ne sont pas signalés. Les mémos écrits par cette intégration ne sont jamais signalés : une scène ne peut pas tourner en boucle sur elle-même. Dix mémos au plus sont signalés par lecture ; les autres sont comptés comme vus.
Actions de scène
- Écrire un mémo dans Memos : Texte du mémo (obligatoire, Markdown ;
insérez des variables de scène avec
{{), et au choix Étiquettes (séparées par des virgules, sans#: elles sont ajoutées à la fin du mémo), Visibilité (privé si rien n'est choisi) et Épingler le mémo. Renvoie Identifiant du mémo, Première ligne et Lien vers le mémo. - Épingler le dernier mémo d'une étiquette : épingle le mémo le plus récent qui porte l'Étiquette, ou le désépingle avec Désépingler plutôt. Mêmes résultats. Échoue quand aucun mémo ne porte l'étiquette.
Exemples de scènes
- Journal de la maison : la porte du garage s'ouvre après 22 h → Écrire
un mémo dans Memos avec
Porte du garage ouverte tard, étiquettesmaison, journal: Memos date le mémo, et le journal se retrouve par étiquette. - Liste de courses sur la tablette de la cuisine : un widget réglé sur
l'étiquette
coursesaffiche les mémos de courses, et Nouveau mémo en ajoute un avec l'étiquette. - Menu de la semaine : chaque lundi à 8 h → Écrire un mémo dans Memos
Menu de la semaine, étiquettemenu, Épingler le mémo coché ; chaque dimanche soir → Épingler le dernier mémo d'une étiquettemenuavec Désépingler plutôt. - Message de la famille : déclencheur Nouveau mémo avec une étiquette
gladys→ dire ou envoyer\{\{triggerEvent.data.author\}\} : \{\{triggerEvent.data.content\}\}. - Rappel des tâches : chaque soir à 20 h → continuer seulement si Mémos avec tâches à faire est supérieur à 0 → envoyer un message « Il reste des tâches dans Memos ».
Dépannage
- « Memos a refusé le jeton d'accès » : le jeton a été supprimé, a expiré ou est mal recopié. Créez-en un nouveau dans Memos → Paramètres → Jetons d'accès.
- « Memos ne répond pas » : vérifiez l'adresse et le port depuis la machine
Gladys. Le conteneur est sur un réseau en pont :
localhostdésigne le conteneur lui-même, saisissez plutôt l'adresse IP du serveur. - « Cette adresse ne répond pas comme Memos » : une page de connexion d'un proxy répond à la place de Memos. Saisissez l'adresse de Memos lui-même, ou laissez passer la machine Gladys.
- « Ce Memos est trop ancien » : mettez Memos à jour (0.31 ou plus).
- « Memos n'a pas encore de compte » : ouvrez Memos une fois, créez l'administrateur, puis le jeton.
- Un déclencheur avec étiquette ne part pas : vérifiez les majuscules de
l'étiquette (
Maisonn'est pasmaison) et que le mémo n'est pas écrit par cette intégration. - Pour plus de détails dans les journaux de l'intégration, réglez
LOG_LEVEL=debug. Le contenu des mémos n'est jamais écrit dans les journaux.
Limites
- L'appareil est identifié par le nom d'utilisateur Memos : renommer l'utilisateur dans Memos crée un nouvel appareil, et les déclencheurs repartent d'une lecture silencieuse.
- Un serveur Memos et un utilisateur : le propriétaire du jeton. Les compteurs comptent les mémos de cet utilisateur ; la liste, le widget et les déclencheurs montrent aussi les mémos que les autres utilisateurs partagent (protégés ou publics).
- Les déclencheurs partent à la lecture suivante (5 minutes par défaut), pas instantanément.
- Un mémo est écrit en texte Markdown seulement : ni pièce jointe, ni lieu, ni commentaire.
- L'intégration ne supprime ni n'archive jamais rien dans Memos.
- Sans lien avec le projet Memos.
Paramètres de configuration
Voici les paramètres demandés par Memos dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connecter Memos | section | Non | Saisissez l'adresse de votre serveur Memos (port 5230 par défaut) et un jeton d'accès : dans Memos, ouvrez Paramètres → Jetons d'accès et créez-en un. L'intégration lit vos compteurs et vos derniers mémos, et écrit les mémos que vos scènes lui envoient. Testée avec Memos 0.31. |
| Adresse de Memos | string | Oui | |
| Jeton d'accès | secret | Oui | Memos → Paramètres → Jetons d'accès → Créer. Les mémos sont écrits au nom de cet utilisateur. |
| Lire Memos toutes les | select | Non | Les nouveaux mémos sont signalés aux scènes à la lecture suivante. |
| Langue des noms et des messages | select | Non | Les noms des fonctionnalités sont fixés à l'ajout de l'appareil dans Gladys. |
Comment installer Memos dans Gladys
- Dans Gladys, ouvrez Intégrations : Memos apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-memos:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-memos.
Memos nécessite Gladys >=5.2.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Memos est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation