Intégration domotique linkding, gratuite et open source

Vos favoris linkding dans Gladys : compteurs, non lus, nouveaux favoris, favoris ajoutés par scène.
Reliez Gladys à linkding, le gestionnaire de favoris auto-hébergé : suivez vos compteurs (favoris, non lus, archivés), voyez vos favoris non lus sur le tableau de bord, réagissez quand un favori est ajouté, lisez les plus récents dans un message et, si vous l'autorisez, enregistrez des liens depuis vos scènes. Tout reste sur votre réseau local : Gladys parle directement à votre serveur linkding.
Testé contre un vrai serveur linkding 1.47.0 (l'image Docker officielle). Vos retours sont les bienvenus sur le forum de Gladys.
Prérequis
- Gladys Assistant 5.1 ou plus.
- linkding, joignable depuis la machine de Gladys, sur le port 9090 par défaut, ou derrière un proxy inverse.
- Un jeton d'API : dans linkding, ouvrez Settings → Integrations et créez un jeton dans la section REST API. L'intégration voit les favoris de l'utilisateur propriétaire du jeton.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Dans Adresse de linkding, saisissez l'adresse IP du serveur, par
exemple
192.168.1.50: l'intégration utilise alors le port 9090. Ajoutez un port si le vôtre diffère (192.168.1.50:9091). Derrière un proxy inverse, saisissez l'adresse complète (https://liens.example.org, avec son chemin si linkding est servi sous un chemin). - Collez le Jeton d'API.
- Filtres (facultatif) : une Étiquette (
alire) et/ou une Recherche (des mots, comme dans le champ de recherche de linkding). Les compteurs, le widget, le déclencheur Nouveau favori et Lire les derniers favoris linkding ne tiennent alors compte que des favoris qui correspondent. Laissez les deux vides pour tous les favoris. - Lire linkding toutes les : 5, 15 (par défaut), 30 ou 60 minutes.
- Autoriser les scènes à ajouter des favoris : désactivé par défaut. Activez-le pour utiliser l'action de scène Ajouter un favori à linkding.
- Langue des noms et messages fixe les noms des fonctionnalités (figés à 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 linkding et le nombre de favoris.
- Dans l'onglet Découverte, ajoutez l'appareil linkding.
Appareils
linkding (un appareil) :
| Fonctionnalité | Valeur |
|---|---|
| Serveur joignable | 1 quand linkding répond, 0 sinon |
| Favoris | nombre de favoris, hors favoris archivés |
| Favoris non lus | nombre de favoris marqués non lus |
| Favoris archivés | nombre de favoris archivés |
| Dernier favori | titre du favori le plus récent (son domaine sans titre) |
| Version de linkding | version du serveur, par exemple 1.47.0 |
Les filtres de la configuration s'appliquent aux trois compteurs et au dernier favori. Les compteurs gardent leur historique : un graphique montre comment votre pile de lecture grandit. Quand linkding ne répond pas, Serveur joignable passe à 0 et les compteurs gardent leur dernière valeur.
Widget du tableau de bord
linkding : deux tuiles (non lus, favoris) et les six favoris non lus les plus récents, avec leur domaine, leur date et leurs étiquettes. Touchez un favori pour lire sa description et l'ouvrir (liens https seulement). Dans les réglages du widget, Liste affiche plutôt les derniers favoris (les non lus portent alors un badge Non lu), et Afficher les compteurs masque les deux tuiles.
Déclencheurs de scène
Nouveau favori : un favori correspondant aux filtres de la configuration est ajouté à linkding, depuis l'application web, l'extension du navigateur ou l'API. Les imports (dont les favoris gardent leurs anciennes dates) et les favoris ajoutés par cette intégration ne sont pas annoncés.
Variables : Titre, Lien, Description, Étiquettes (séparées par des virgules), Non lu et Identifiant du favori.
La première lecture après l'installation est silencieuse : les favoris déjà présents ne sont pas annoncés. Dix événements au plus partent par lecture ; le reste est compté comme vu.
Actions de scène
- Ajouter un favori à linkding (activez d'abord Autoriser les scènes à ajouter des favoris) : Lien (obligatoire) et, si vous le souhaitez, Titre (vide : linkding lit le titre de la page), Étiquettes (séparées par des espaces ou des virgules ; les étiquettes absentes sont créées) et Marquer comme non lu. Un lien déjà présent dans linkding est laissé tel quel (linkding remplacerait sinon son titre et ses étiquettes). Renvoie Identifiant du favori, Titre et Déjà enregistré.
- Lire les derniers favoris linkding : Favoris (non lus seulement, par
défaut, ou tous) et Nombre de favoris (1, 3, 5 ou 10). Renvoie Nombre
de favoris lus, Favoris, un par ligne (
titre — adresse), Titre du favori le plus récent et Adresse du favori le plus récent.
Exemples de scènes
- Nouvelle lecture sur le téléphone : déclencheur Nouveau favori → envoyer un message « À lire : {{triggerEvent.data.title}} {{triggerEvent.data.url}} ».
- Lecture du dimanche : chaque dimanche à 10 h → Lire les derniers favoris linkding, non lus seulement, 5 favoris → envoyer un message avec la sortie Favoris, un par ligne.
- Garder le clip de la caméra : quand une autre intégration donne
l'adresse d'un clip → Ajouter un favori à linkding avec cette adresse,
étiquette
sonnette. - Pile de lecture : chaque soir → continuer seulement si Favoris non lus dépasse 30 → envoyer un message « Votre pile de lecture dépasse 30 favoris ».
- Serveur arrêté : Serveur joignable passe à 0 → envoyer un message.
Dépannage
- « linkding a refusé le jeton d'API » : le jeton a été supprimé ou mal saisi. Créez-en un nouveau dans linkding → Settings → Integrations.
- « linkding ne répond pas » : vérifiez l'adresse et le port depuis la
machine de Gladys. Le conteneur est sur un réseau en pont :
localhostest le conteneur lui-même, saisissez plutôt l'adresse IP du serveur. - « Cette adresse ne répond pas comme linkding » : une page de connexion du proxy répond à la place de linkding, ou le chemin est faux. Saisissez l'adresse de linkding lui-même.
- « L'ajout de favoris par les scènes est désactivé » : activez Autoriser les scènes à ajouter des favoris dans la configuration.
- Pour plus de détails dans les journaux de l'intégration, réglez
LOG_LEVEL=debug.
Limites
- Un seul utilisateur linkding : le propriétaire du jeton.
- Le déclencheur part à la lecture suivante (15 minutes par défaut), pas instantanément : linkding ne pousse rien. Il lit les 50 favoris les plus récents : au-delà de 50 ajouts entre deux lectures, les plus anciens ne sont pas annoncés.
- Un favori ajouté directement archivé est compté mais pas annoncé.
- L'intégration ne supprime, ne modifie et n'archive jamais rien dans linkding.
- Sans lien avec le projet linkding.
Paramètres de configuration
Voici les paramètres demandés par linkding dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connecter linkding | section | Non | Saisissez l'adresse de votre serveur linkding (port 9090 par défaut) et un jeton d'API : dans linkding, ouvrez Settings → Integrations et créez-en un. L'intégration lit vos compteurs et vos derniers favoris, et peut enregistrer les liens que vos scènes lui envoient. |
| Adresse de linkding | string | Oui | |
| Jeton d'API | secret | Oui | linkding → Settings → Integrations → REST API : créez un jeton. |
| Filtres (facultatif) | section | Non | Compteurs, liste, déclencheur « Nouveau favori » et lecture par scène ne tiennent compte que des favoris qui correspondent à ces filtres. Laissez vide pour tous les favoris. |
| Étiquette | string | Non | Une étiquette, sans # ni espace, comme dans linkding. |
| Recherche | string | Non | Mots recherchés comme dans linkding (titre, description, adresse, notes). |
| Lire linkding toutes les | select | Non | Les nouveaux favoris sont annoncés à la lecture suivante. Les favoris enregistrés depuis Gladys mettent les compteurs à jour aussitôt. |
| Autoriser les scènes à ajouter des favoris | boolean | Non | Désactivé par défaut : l'action de scène « Ajouter un favori » est refusée tant que vous ne l'activez pas. Un lien déjà enregistré n'est jamais modifié. |
| Langue des noms et messages | select | Non | Les noms des fonctionnalités sont fixés à l'ajout d'un appareil dans Gladys. |
Comment installer linkding dans Gladys
- Dans Gladys, ouvrez Intégrations : linkding 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-linkding: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-linkding.
linkding nécessite Gladys >=5.1.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
linkding 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