Intégration domotique Linkwarden, gratuite et open source
Vos liens Linkwarden dans Gladys : compteurs, nouveaux liens, liens enregistrés et lus par scène.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.2.0
- ★ 0
Reliez Gladys à Linkwarden, l'application auto-hébergée pour collecter, ranger et conserver des liens : suivez vos compteurs, réagissez quand un lien est enregistré dans une collection, enregistrez des liens depuis vos scènes ou le tableau de bord, et lisez les plus récents dans un message. Tout reste sur votre réseau local : Gladys parle directement à votre serveur Linkwarden.
Testée sur un vrai serveur Linkwarden 2.16.3 (l'image Docker officielle). Vos retours sont les bienvenus sur le forum de Gladys.
Prérequis
- Gladys Assistant 5.2 ou plus.
- Linkwarden 2.10 ou plus, joignable depuis la machine de Gladys, sur le port 3000 par défaut, ou derrière un reverse proxy.
- Un jeton d'accès : dans Linkwarden, ouvrez Paramètres → Jetons d'accès et créez-en un. Choisissez l'expiration Jamais, ou notez la date pour le renouveler. L'intégration voit les liens de l'utilisateur à qui appartient le jeton, collections partagées comprises.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Dans Adresse de Linkwarden, saisissez l'adresse IP du serveur, par
exemple
192.168.1.50: l'intégration utilise alors le port 3000. Ajoutez un port si le vôtre est différent (192.168.1.50:3100). Derrière un reverse proxy, saisissez l'adresse complète (https://liens.example.org). - Collez le Jeton d'accès.
- Lire Linkwarden toutes les : 5, 15, 30 (par défaut) ou 60 minutes. Les nouveaux liens sont annoncés à la lecture suivante ; les liens enregistrés depuis Gladys mettent les compteurs à jour aussitôt.
- Langue des noms et messages fixe le nom des fonctionnalités (figé à l'ajout d'un appareil) et les textes de l'intégration. Français par défaut.
- Enregistrez, puis utilisez Tester la connexion : elle affiche l'utilisateur Linkwarden et le nombre de liens et de collections.
- Dans l'onglet Découverte, ajoutez l'appareil Linkwarden, et les collections que vous voulez suivre.
Appareils
Linkwarden (un appareil pour l'utilisateur du jeton) :
| Fonctionnalité | Valeur |
|---|---|
| Liens | nombre de liens, toutes collections confondues |
| Liens ajoutés aujourd'hui | liens enregistrés ou importés depuis minuit |
| Collections | nombre de collections, sous-collections comprises |
| Dernier lien | nom du lien le plus récent (son domaine s'il n'en a pas) |
Un appareil par collection (nommé comme la collection, Parent / Enfant
pour une sous-collection), avec une fonctionnalité, Liens : le nombre de
liens rangés directement dans la collection. N'ajoutez que celles qui vous
intéressent.
Les compteurs gardent leur historique : un graphique montre comment une collection grandit.
Widget du tableau de bord
Linkwarden : trois tuiles (liens, aujourd'hui, collections), les six liens
les plus récents et un bouton Enregistrer un lien. Dans les réglages du
widget, Collection choisit un appareil collection : le widget affiche alors
son nombre de liens et ses liens les plus récents, et enregistre dedans.
Touchez un lien pour lire sa description et l'ouvrir (liens https seulement ;
Ouvrir dans Linkwarden apparaît quand Linkwarden est joint en https).
Enregistrer un lien ouvre un formulaire : saisissez un lien (https://… ou
www.…) et l'intégration l'enregistre.
Déclencheurs de scène
Nouveau lien : un lien est enregistré dans Linkwarden, depuis l'application web, l'extension du navigateur, l'application mobile ou un flux RSS. Le filtre Collection ne garde que les liens d'une collection (choisissez un appareil collection ; vide : toutes). Les imports et les liens enregistrés par cette intégration ne sont pas annoncés.
Variables : Nom, Lien, Description, Collection (son nom), Étiquettes (séparées par des virgules) et Identifiant du lien.
La première lecture après l'installation est silencieuse : les liens 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
- Enregistrer un lien dans Linkwarden : Lien (obligatoire), et en
option Nom (vide : Linkwarden prend le titre de la page), Collection
(le nom d'une collection existante, majuscules ou minuscules indifférentes,
Parent/Enfantpour une sous-collection ; vide : Unorganized) et Étiquettes (séparées par des virgules ; les étiquettes absentes sont créées). Une collection inconnue est une erreur : l'intégration n'en crée jamais. Renvoie Identifiant du lien, Nom, Collection et Déjà enregistré (vrai quand Linkwarden refuse les doublons, un réglage de ses préférences, et que le lien y est déjà). - Lire les derniers liens Linkwarden : Collection (facultative, comme
ci-dessus) et Nombre de liens (1, 3, 5 ou 10). Renvoie Nombre de liens
lus, Liens, un par ligne (
nom — adresse), Nom du lien le plus récent et Adresse du lien le plus récent.
Exemples de scènes
- Recettes sur le téléphone : déclencheur Nouveau lien, collection Recettes → envoyer un message « Nouvelle recette : {{triggerEvent.data.name}} {{triggerEvent.data.url}} ».
- Lecture du dimanche : chaque dimanche à 10 h → Lire les derniers liens
Linkwarden, collection
À lire, 5 liens → envoyer un message avec la sortie Liens, un par ligne. - Garder le clip de la caméra : quand une autre intégration fournit
l'adresse d'un clip → Enregistrer un lien dans Linkwarden avec cette
adresse, collection
Caméras, étiquettesonnette. - Pile de lecture : chaque soir → continuer seulement si la fonctionnalité
Liens de la collection
À liredépasse 30 → envoyer un message « Votre pile de lecture dépasse 30 liens ».
Dépannage
- « Linkwarden a refusé le jeton d'accès » : le jeton a été révoqué, a expiré ou est mal recopié. Créez-en un nouveau dans Linkwarden → Paramètres → Jetons d'accès.
- « Linkwarden 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 :
localhostdésigne le conteneur lui-même, saisissez plutôt l'adresse IP du serveur. - « Cette adresse ne répond pas comme Linkwarden 2.10 ou plus » : une page de connexion d'un proxy répond à la place de Linkwarden, ou Linkwarden est trop ancien. Saisissez l'adresse de Linkwarden lui-même, ou mettez-le à jour.
- « Aucune collection … dans Linkwarden » : la collection de l'action de scène doit exister. Créez-la d'abord dans Linkwarden.
- Une collection manque dans le filtre du déclencheur ou les réglages du widget : ajoutez d'abord son appareil dans l'onglet Découverte.
- Pour voir plus de détails dans les journaux de l'intégration, réglez
LOG_LEVEL=debug.
Limites
- Un seul utilisateur Linkwarden : le propriétaire du jeton.
- Le déclencheur part à la lecture suivante (30 minutes par défaut), pas instantanément : Linkwarden ne pousse rien.
- Liens ajoutés aujourd'hui et le déclencheur lisent jusqu'à 500 liens par lecture : au-delà, le compte du jour s'arrête à 500 et les plus anciens ne sont pas annoncés.
- La découverte propose les 100 premières collections.
- L'intégration ne supprime, ne déplace et n'archive jamais rien dans Linkwarden.
- Sans lien avec le projet Linkwarden.
Paramètres de configuration
Voici les paramètres demandés par Linkwarden dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connecter Linkwarden | section | Non | Saisissez l'adresse de votre serveur Linkwarden (port 3000 par défaut) et un jeton d'accès : dans Linkwarden, ouvrez Paramètres → Jetons d'accès et créez-en un. L'intégration lit vos compteurs et vos derniers liens, et enregistre les liens que vos scènes lui envoient. |
| Adresse de Linkwarden | string | Oui | |
| Jeton d'accès | secret | Oui | Linkwarden → Paramètres → Jetons d'accès → Nouveau jeton (expiration : jamais, ou pensez à le renouveler). |
| Lire Linkwarden toutes les | select | Non | Les nouveaux liens sont annoncés à la lecture suivante. Les liens enregistrés depuis Gladys mettent les compteurs à jour aussitôt. |
| Langue des noms et messages | select | Non | Les noms des fonctionnalités sont fixés à l'ajout d'un appareil dans Gladys. |
Comment installer Linkwarden dans Gladys
- Dans Gladys, ouvrez Intégrations : Linkwarden 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-linkwarden:1.0.1), 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-linkwarden.
Linkwarden 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
Linkwarden 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