Zum Hauptinhalt springen

Miniflux Smart-Home-Integration, kostenlos und Open Source

Miniflux-Integration für Gladys Assistant

Dein Miniflux-Reader in Gladys: Ungelesene, neue Artikel, Feeds mit Fehler, als gelesen.

Auf GitHub ansehenAlle Integrationen

Verbinde Gladys mit Miniflux, dem minimalistischen Feed-Reader: Verfolge deine ungelesenen Artikel pro Kategorie, reagiere auf einen neuen Artikel oder auf einen Feed, der nicht mehr funktioniert, markiere Artikel aus deinen Szenen als gelesen und zeige die neuesten ungelesenen Artikel auf dem Dashboard. Die Integration folgt dem Zustand deines Readers (gelesen / ungelesen, auf all deinen Geräten gleich), nicht den Feeds selbst.

Getestet mit einem echten Miniflux 2.3.4 (das offizielle Docker-Image) und Test-Feeds. Rückmeldungen sind im Gladys-Forum willkommen.

Voraussetzungen​

  • Gladys Assistant 5.1 oder neuer.
  • Miniflux 2, selbst gehostet (standardmäßig Port 8080, oder hinter einem Reverse Proxy) oder der gehostete Dienst reader.miniflux.app, erreichbar vom Gladys-Rechner.
  • Ein API-Schlüssel: Öffne in Miniflux Einstellungen → API-Schlüssel und erstelle einen. Die Integration sieht die Feeds des Benutzers, dem der Schlüssel gehört.

Konfiguration​

  1. Öffne den Reiter Konfiguration der Integration.
  2. Gib unter Miniflux-Adresse die Adresse des Servers ein, zum Beispiel 192.168.1.50:8080 (Port 8080, wenn keiner angegeben ist), oder eine vollständige Adresse wie https://rss.example.org oder https://reader.miniflux.app.
  3. Füge den API-Schlüssel ein.
  4. Optional: Miniflux lesen alle (standardmäßig 5 Minuten) und Zu beobachtende Stichwörter, durch Kommas getrennt, für den Stichwortfilter des Auslösers „Neuer Artikel“.
  5. Klicke auf Verbindung testen: Der Test zeigt den Benutzer, die ungelesenen Artikel und die Feeds mit Fehler.
  6. Öffne den Reiter Erkennung und füge die gewünschten Geräte hinzu.

Geräte​

  • Miniflux: Ungelesene Artikel (alle Kategorien) und Feeds mit Fehler (Feeds, die Miniflux bei seiner letzten Prüfung nicht lesen konnte, deaktivierte Feeds ausgenommen).
  • Ein Gerät pro Kategorie (für jede Miniflux-Kategorie angeboten): ihre Ungelesenen Artikel.

Die Werte werden alle paar Minuten gelesen (die Einstellung oben) und direkt nach jeder Änderung aus Gladys. Der Verlauf behält sie, für ein Diagramm deines Stapels an Ungelesenem.

Dashboard-Widget​

Miniflux: die Anzahl ungelesener Artikel (und der Feeds mit Fehler, in Rot, wenn es welche gibt), die sechs neuesten ungelesenen Artikel (Feed, Datum, Zusammenfassung, Links zum Artikel und zu Miniflux, wenn sie https sind), eine Taste Aktualisieren, mit der Miniflux die Feeds jetzt abruft, und eine Taste Als gelesen, mit Bestätigung, die die aufgelisteten Artikel (nur sie) als gelesen markiert. Auf ein Kategorie-Gerät eingestellt, zeigt und aktualisiert das Widget nur diese Kategorie.

Szenen-Auslöser​

  • Neuer Artikel: Ein ungelesener Artikel ist in Miniflux angekommen. Filter: eine Kategorie (ein Kategorie-Gerät), ein Feed (sein Titel, genau wie in Miniflux), ein Stichwort (eines der Stichwörter der Konfiguration, im Titel gefunden, ohne Rücksicht auf Groß- und Kleinschreibung und Akzente). Weitergegebene Informationen: Titel, Link, Feed, Kategorie, Autor, gefundenes Stichwort, Veröffentlichungsdatum und Artikel-ID.
  • Feed mit Fehler: Miniflux kann einen Feed nicht mehr lesen, der bisher funktioniert hat. Filter: eine Kategorie. Weitergegebene Informationen: Feed, Kategorie, Fehlermeldung, fehlgeschlagene Prüfungen, Adresse der Website, Feed-ID.

Beim ersten Lesen nach der Installation wird nichts ausgelöst, ebenso wenig für die Artikel, die beim Hinzufügen eines Feeds schon da sind, oder für Artikel, die schon auf einem anderen Gerät gelesen wurden. Höchstens 10 Artikel werden pro Lesen gemeldet.

Szenen-Aktionen​

  • Miniflux-Kategorie als gelesen markieren: alle ungelesenen Artikel einer Kategorie; wähle das Miniflux-Gerät, um alles zu markieren. Ergebnisse: markierte Artikel, Kategorie.
  • Miniflux-Artikel als gelesen markieren: eine oder mehrere Artikel-IDs, typischerweise die Artikel-ID des Auslösers „Neuer Artikel“. Ergebnis: markierte Artikel.
  • Miniflux-Feeds aktualisieren: Miniflux ruft jetzt alle Feeds ab (oder die einer Kategorie), vier auf einmal; die neuen Artikel werden danach gelesen. Ergebnis: aktualisierte Feeds.
  • Ungelesene Miniflux-Titel lesen: die neuesten ungelesenen Artikel (1 bis 10), aller Kategorien oder einer, auf Wunsch danach als gelesen markiert. Ergebnisse: gelesene Anzahl, ungelesene Artikel insgesamt, Titel einer pro Zeile („Titel — Feed“), Titel, Link und Feed des neuesten.

Szenen-Beispiele​

  • Morgenübersicht: um 7:30 Ungelesene Miniflux-Titel lesen (Kategorie Nachrichten, 5 Artikel, danach als gelesen markieren), dann eine Telegram-Nachricht mit seinem Ergebnis Titel senden (mit der Variablenauswahl einfügen).
  • Ein Thema beobachten: mit Gladys in den Stichwörtern, Neuer Artikel mit dem Stichwort Gladys → eine Nachricht mit Titel und Link des Artikels senden, dann Miniflux-Artikel als gelesen markieren mit seiner Artikel-ID.
  • Kaputter Feed: Feed mit Fehler → eine Nachricht mit Feed und Fehlermeldung senden.

Fehlerbehebung​

  • „Miniflux hat den API-Schlüssel abgelehnt“: Der Schlüssel wurde gelöscht oder falsch kopiert: Erstelle einen neuen unter Einstellungen → API-Schlüssel.
  • „Miniflux antwortet nicht“: Prüfe Adresse und Port vom Gladys-Rechner aus. Hinter einem Reverse Proxy gib die vollständige Adresse samt Pfad ein.
  • „Diese Adresse antwortet nicht wie Miniflux“: Die Adresse führt zu einem anderen Dienst oder zu einer Anmeldeseite (ein Authentifizierungs-Proxy vor Miniflux muss /v1/ mit dem Header X-Auth-Token durchlassen).
  • Kein Ereignis „Neuer Artikel“: Artikel kommen an, wenn Miniflux die Feeds prüft (auf seiner Seite standardmäßig alle 60 Minuten), dann beim nächsten Lesen der Integration. Miniflux-Feeds aktualisieren beschleunigt das.
  • Mehr Details: Setze die Variable LOG_LEVEL der Integration auf debug.

Grenzen​

  • Die Filter der Auslöser vergleichen nur exakte Werte: Der Feed-Filter ist der genaue Titel, der Stichwortfilter eines der konfigurierten Stichwörter.
  • Favoriten, Leseverlauf und die Feeds selbst werden nicht aus Gladys verwaltet.
  • Die Links des Widgets öffnen nur https-Adressen: Ein Artikel oder ein Miniflux über einfaches http hat keinen Link.
  • Nicht mit Miniflux verbunden.

Konfigurationseinstellungen​

Diese Einstellungen fragt Miniflux in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Miniflux verbindensectionNeinGib die Adresse deines Miniflux (standardmäßig Port 8080, oder seine öffentliche Adresse) und einen API-Schlüssel ein: Öffne in Miniflux Einstellungen → API-Schlüssel und erstelle einen. Die Integration liest deine Ungelesen-Zähler, meldet neue Artikel und Feeds mit Fehler und markiert Artikel aus deinen Szenen als gelesen.
Miniflux-AdressestringJa
API-SchlüsselsecretJaMiniflux → Einstellungen → API-Schlüssel → Neuen API-Schlüssel erstellen.
Miniflux lesen alleselectNeinNeue Artikel werden beim nächsten Lesen gemeldet. Miniflux selbst prüft die Feeds standardmäßig alle 60 Minuten.
Zu beobachtende Stichwörter (optional)stringNeinDurch Kommas getrennt. Ein neuer Artikel, dessen Titel eines enthält, trägt es für den Stichwortfilter des Auslösers.
Sprache der Namen und MeldungenselectNeinDie Namen der Funktionen werden beim Hinzufügen eines Geräts zu Gladys festgelegt.

So installierst du Miniflux in Gladys​

  1. Öffne in Gladys Integrationen: Miniflux erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-miniflux:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-miniflux.

Miniflux benötigt Gladys >=5.1.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​

Miniflux 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am