Linkwarden Smart-Home-Integration, kostenlos und Open Source
Deine Linkwarden-Links in Gladys: Zähler, neue Links, Links aus Szenen speichern und lesen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Verbinde Gladys mit Linkwarden, der selbst gehosteten App zum Sammeln, Ordnen und Bewahren von Links: Verfolge deine Zähler, reagiere, wenn ein Link in einer Sammlung gespeichert wird, speichere Links aus deinen Szenen oder vom Dashboard und lies die neuesten in einer Nachricht. Alles bleibt in deinem lokalen Netz: Gladys spricht direkt mit deinem Linkwarden-Server.
Getestet mit einem echten Linkwarden-2.16.3-Server (dem offiziellen Docker-Image). Rückmeldungen sind im Gladys-Forum willkommen.
Voraussetzungen
- Gladys Assistant 5.2 oder neuer.
- Linkwarden 2.10 oder neuer, erreichbar von der Gladys-Maschine, standardmäßig auf Port 3000 oder über einen Reverse Proxy.
- Ein Zugangstoken: Öffne in Linkwarden Einstellungen → Zugangstokens und erstelle eines. Wähle als Ablauf Nie, oder notiere dir das Datum, um es zu erneuern. Die Integration sieht die Links des Benutzers, dem das Token gehört, geteilte Sammlungen eingeschlossen.
Konfiguration
- Öffne den Reiter Konfiguration der Integration.
- Gib unter Linkwarden-Adresse die IP-Adresse des Servers ein, zum
Beispiel
192.168.1.50: Die Integration nutzt dann Port 3000. Ergänze einen Port, wenn deiner abweicht (192.168.1.50:3100). Hinter einem Reverse Proxy gib die vollständige Adresse ein (https://links.example.org). - Füge das Zugangstoken ein.
- Linkwarden lesen alle: 5, 15, 30 (Standard) oder 60 Minuten. Neue Links werden beim nächsten Lesen gemeldet; aus Gladys gespeicherte Links aktualisieren die Zähler sofort.
- Sprache der Namen und Meldungen legt die Namen der Funktionen (beim Hinzufügen eines Geräts festgelegt) und die Texte der Integration fest. Standardmäßig Französisch.
- Speichere und nutze dann Verbindung testen: Der Test zeigt den Linkwarden-Benutzer und die Anzahl der Links und Sammlungen.
- Füge im Reiter Erkennung das Gerät Linkwarden hinzu und die Sammlungen, die du verfolgen willst.
Geräte
Linkwarden (ein Gerät für den Benutzer des Tokens):
| Funktion | Wert |
|---|---|
| Links | Anzahl der Links, in allen Sammlungen |
| Heute hinzugefügte Links | seit Mitternacht gespeicherte oder importierte Links |
| Sammlungen | Anzahl der Sammlungen, Untersammlungen eingeschlossen |
| Neuester Link | Name des neuesten Links (seine Domain, wenn er keinen hat) |
Ein Gerät pro Sammlung (benannt wie die Sammlung, Eltern / Kind für eine
Untersammlung) mit einer Funktion, Links: die Anzahl der Links direkt in
der Sammlung. Füge nur die hinzu, die dich interessieren.
Die Zähler behalten ihren Verlauf: Ein Diagramm zeigt, wie eine Sammlung wächst.
Dashboard-Widget
Linkwarden: drei Kacheln (Links, heute, Sammlungen), die sechs neuesten
Links und eine Taste Link speichern. In den Widget-Einstellungen wählt
Sammlung ein Sammlungsgerät: Das Widget zeigt dann ihre Anzahl an Links und
ihre neuesten Links und speichert darin. Tippe auf einen Link, um seine
Beschreibung zu lesen und ihn zu öffnen (nur https-Links; In Linkwarden
öffnen erscheint, wenn Linkwarden über https erreicht wird). Link
speichern öffnet ein Formular: Gib einen Link ein (https://… oder
www.…), und die Integration speichert ihn.
Szenen-Auslöser
Neuer Link: Ein Link wird in Linkwarden gespeichert, aus der Web-App, der Browser-Erweiterung, der mobilen App oder einem RSS-Feed. Der Filter Sammlung behält nur die Links einer Sammlung (wähle ein Sammlungsgerät; leer: alle). Importe und die Links dieser Integration werden nicht gemeldet.
Variablen: Name, Link, Beschreibung, Sammlung (ihr Name), Tags (durch Kommas getrennt) und Link-ID.
Das erste Lesen nach der Installation bleibt still: Bereits vorhandene Links werden nicht gemeldet. Pro Lesen werden höchstens zehn Ereignisse ausgelöst; der Rest gilt als gesehen.
Szenen-Aktionen
- Link in Linkwarden speichern: Link (Pflicht) und optional Name
(leer: Linkwarden nimmt den Titel der Seite), Sammlung (der Name einer
vorhandenen Sammlung, Groß- und Kleinschreibung egal,
Eltern/Kindfür eine Untersammlung; leer: Unorganized) und Tags (durch Kommas getrennt; fehlende Tags werden angelegt). Eine unbekannte Sammlung ist ein Fehler: Die Integration legt nie eine an. Gibt Link-ID, Name, Sammlung und Schon gespeichert zurück (wahr, wenn Linkwarden Duplikate ablehnt, eine Option seiner Einstellungen, und der Link schon da ist). - Neueste Linkwarden-Links lesen: Sammlung (optional, wie oben) und
Anzahl der Links (1, 3, 5 oder 10). Gibt Anzahl gelesener Links,
Links, einer pro Zeile (
Name — Adresse), Name des neuesten Links und Adresse des neuesten Links zurück.
Szenen-Beispiele
- Rezepte aufs Handy: Auslöser Neuer Link, Sammlung Rezepte → Nachricht senden „Neues Rezept: {{triggerEvent.data.name}} {{triggerEvent.data.url}}“.
- Sonntagslektüre: jeden Sonntag um 10:00 → Neueste Linkwarden-Links
lesen, Sammlung
Lesen, 5 Links → eine Nachricht mit der Ausgabe Links, einer pro Zeile senden. - Kamera-Clip aufheben: Wenn eine andere Integration die Adresse eines
Clips liefert → Link in Linkwarden speichern mit dieser Adresse,
Sammlung
Kameras, TagTürklingel. - Lesestapel: jeden Abend → nur fortfahren, wenn die Funktion Links
der Sammlung
Lesenüber 30 liegt → Nachricht senden „Dein Lesestapel hat mehr als 30 Links“.
Fehlerbehebung
- „Linkwarden hat das Zugangstoken abgelehnt“: Das Token wurde widerrufen, ist abgelaufen oder falsch abgeschrieben. Erstelle ein neues unter Linkwarden → Einstellungen → Zugangstokens.
- „Linkwarden antwortet nicht“: Prüfe Adresse und Port von der
Gladys-Maschine aus. Der Container läuft in einem Bridge-Netz:
localhostist der Container selbst, gib stattdessen die IP-Adresse des Servers ein. - „Diese Adresse antwortet nicht wie Linkwarden 2.10 oder neuer“: Eine Anmeldeseite eines Proxys antwortet statt Linkwarden, oder Linkwarden ist zu alt. Gib die Adresse von Linkwarden selbst ein oder aktualisiere es.
- „Keine Sammlung … in Linkwarden“: Die Sammlung der Szenen-Aktion muss existieren. Lege sie zuerst in Linkwarden an.
- Eine Sammlung fehlt im Filter des Auslösers oder in den Widget-Einstellungen: Füge zuerst ihr Gerät im Reiter Erkennung hinzu.
- Für mehr Details in den Logs der Integration setze
LOG_LEVEL=debug.
Grenzen
- Ein einziger Linkwarden-Benutzer: der Besitzer des Tokens.
- Der Auslöser reagiert beim nächsten Lesen (standardmäßig 30 Minuten), nicht sofort: Linkwarden schickt nichts von selbst.
- Heute hinzugefügte Links und der Auslöser lesen bis zu 500 Links pro Lesen: Darüber hinaus bleibt der Tageszähler bei 500 stehen, und die ältesten werden nicht gemeldet.
- Die Erkennung bietet die ersten 100 Sammlungen an.
- Die Integration löscht, verschiebt und archiviert in Linkwarden nie etwas.
- Nicht mit dem Linkwarden-Projekt verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Linkwarden in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Linkwarden verbinden | section | Nein | Gib die Adresse deines Linkwarden-Servers (standardmäßig Port 3000) und ein Zugangstoken ein: Öffne in Linkwarden Einstellungen → Zugangstokens und erstelle eines. Die Integration liest deine Zähler und neuesten Links und speichert die Links, die deine Szenen ihr schicken. |
| Linkwarden-Adresse | string | Ja | |
| Zugangstoken | secret | Ja | Linkwarden → Einstellungen → Zugangstokens → Neues Token (Ablauf: nie, oder erneuere es rechtzeitig). |
| Linkwarden lesen alle | select | Nein | Neue Links werden beim nächsten Lesen gemeldet. Aus Gladys gespeicherte Links aktualisieren die Zähler sofort. |
| Sprache der Namen und Meldungen | select | Nein | Die Namen der Funktionen werden beim Hinzufügen eines Geräts zu Gladys festgelegt. |
So installierst du Linkwarden in Gladys
- Öffne in Gladys Integrationen: Linkwarden erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-linkwarden:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-linkwarden.
Linkwarden benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Linkwarden ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation