Vikunja Smart-Home-Integration, kostenlos und Open Source

Vikunja-Aufgaben: heute, überfällig, Erinnerungen, erledigt oder erstellt per Szene oder Dashboard.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Die Aufgaben deines Vikunja in Gladys: was heute noch zu tun ist, was überfällig ist, die nächste Aufgabe jedes Projekts. Eine Szene reagiert, wenn eine Aufgabe fällig wird oder eine Erinnerung kommt, eine andere legt per Taste „Brot kaufen“ an, ein Tippen im Dashboard hakt eine Aufgabe ab, und Gladys kann dir jeden Morgen die Aufgaben des Tages vorlesen.

Feedback willkommen. Diese Integration wurde mit einem echten Vikunja-Server getestet (Docker-Image vikunja/vikunja v2.7.0, Oktober 2026), noch nicht im Alltag. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.

Was du brauchst

• Gladys Assistant 5.1.0 oder neuer.

• Ein selbst gehostetes Vikunja (0.22 oder neuer), von Gladys aus erreichbar (das Docker-Image lauscht auf Port 3456).

• Ein API-Token eines Vikunja-Benutzers. In Vikunja: Settings → API Tokens → Create a token, gib ihm einen Namen (Gladys), ein Ablaufdatum und diese Berechtigungen:

  • Projects: read_all;
  • Tasks: read_all, read_one, update (um Aufgaben zu erledigen) und create (um Aufgaben anzulegen).

  Kopiere das Token, es beginnt mit tk_: Vikunja zeigt es nur einmal an. Ohne update oder create funktionieren Zähler, Widget und Auslöser trotzdem; nur die passende Aktion wird abgelehnt.

Die Integration sieht die Projekte und Aufgaben, die dieser Benutzer sieht (seine eigenen und die mit ihm geteilten), und handelt in seinem Namen.

Einrichtung

1. In Gladys: Integrationen → Vikunja installieren.
2. Im Bildschirm Konfiguration ausfüllen:
   • Adresse: die Adresse von Vikunja, zum Beispiel http://192.168.1.20:3456, oder https://aufgaben.example.org hinter einem Reverse Proxy (ein Pfadpräfix wie /vikunja bleibt erhalten);
   • API-Token: das tk_…-Token.
3. Optionen:
   • Verfolgte Projekte: Namen oder Nummern, durch Kommas getrennt (Haushalt, 3). Leer: alle Projekte. Archivierte Projekte werden nie verfolgt;
   • Selbstsignierte Zertifikate akzeptieren: für eine https://-Adresse mit selbstsigniertem Zertifikat, nur für deinen eigenen Server;
   • Aktualisierungsintervall: 1 bis 10 Minuten (standardmäßig 5). Fälligkeiten, Erinnerungen und Mitternacht werden unabhängig vom Intervall immer pünktlich berücksichtigt;
   • Sprache der Funktionsnamen: die Namen der Funktionen beim Hinzufügen eines Geräts (standardmäßig Französisch) und die an Szenen gesendeten Texte.
4. Speichern, dann Verbindung testen: Die Integration liest Vikunja und nennt die Version, die Zahl der offenen Aufgaben und der verfolgten Projekte.
5. Im Reiter Entdecken die gewünschten Geräte hinzufügen.

Geräte

Vikunja (alle verfolgten Projekte zusammen) und Vikunja Projekt für jedes verfolgte Projekt. Jedes hat vier Funktionen:

Funktion	Was sie anzeigt
Offene Aufgaben	nicht erledigte Aufgaben, mit oder ohne Fälligkeit
Aufgaben für heute	offene Aufgaben, die vor Mitternacht fällig sind, überfällige inklusive: was bis heute Abend bleibt
Überfällige Aufgaben	offene Aufgaben, deren Fälligkeit vorbei ist
Nächste Aufgabe	der Titel der offenen Aufgabe mit der nächsten noch kommenden Fälligkeit; sonst Keine

„Heute“ ist der Tag in der Zeitzone von Gladys. Ein Unterprojekt ist ein eigenes Projekt: Seine Aufgaben zählen nicht im übergeordneten Projekt.

Dashboard

Das Widget Heutige Aufgaben zeigt zwei Kacheln (heute zu tun, überfällig), die Liste der Aufgaben des Tages, überfällige zuerst, mit Uhrzeit (orange bei hoher Priorität) und Projekt, und eine Taste für jede der vier dringendsten: Ein Tippen markiert die Aufgabe als erledigt. Wähle in den Widget-Einstellungen ein Projektgerät, um nur dessen Aufgaben zu sehen; lass das Feld leer für alle verfolgten Projekte. Wenn nichts mehr übrig ist, sagt das Widget es und zeigt die nächste Aufgabe.

Die Zähler können auch wie jede Gerätefunktion ins Dashboard.

Szenen

Auslöser

• Vikunja-Aufgabe fällig: Eine offene Aufgabe hat ihre Fälligkeit erreicht.
• Vikunja-Erinnerung: Eine Erinnerung einer offenen Aufgabe ist fällig (festes Datum oder relativ zur Fälligkeit: Vikunja berechnet es).
• Vikunja-Aufgabe überfällig: Um Mitternacht ist eine an diesem Tag fällige Aufgabe noch nicht erledigt. Einmal pro Aufgabe und Fälligkeit.

Filter, für alle drei: das Projekt (ein Projektgerät: Das Gerät Vikunja filtert nichts, lass das Feld für alle Projekte leer), der Titel der Aufgabe. An die Aktionen übergebene Informationen: die Aufgabe, ihre Nummer, ihr Projekt, ihre Priorität (0 bis 5), ihre Fälligkeit; und bei einer Erinnerung deren Zeit.

Eine vor ihrer Fälligkeit erledigte Aufgabe löst nichts aus. Eine von Hand auf einen Zeitpunkt vor der letzten Abfrage verschobene Fälligkeit auch nicht: Es zählen nur die Zeitpunkte, die vergehen, während die Integration läuft. Ein Neustart löst nichts zweimal aus; ein Zeitpunkt, der verging, während die Integration gestoppt war, löst beim Neustart aus, wenn er weniger als eine Stunde her ist.

Aktionen

• Vikunja-Aufgabe als erledigt markieren: Gib den genauen Titel (Groß- und Kleinschreibung und Akzente egal) oder die Nummer der Aufgabe an (#12, die Nummer in der Adresse der Aufgabe in Vikunja). Jede offene Aufgabe, die das Token sieht, verfolgtes Projekt oder nicht. Eine wiederholte Aufgabe springt wie in Vikunja zur nächsten Fälligkeit. Ergebnisse: die Aufgabe, ihre Nummer, ihr Projekt, die nächste Fälligkeit einer wiederholten Aufgabe.
• Vikunja-Aufgabe erstellen: ein Titel und das Projekt per Name oder Nummer (leer: das erste Projekt der Liste in Vikunja, meist Inbox). Ergebnisse: die Aufgabe, ihre Nummer, ihr Projekt.
• Heutige Vikunja-Aufgaben lesen: die Aufgaben des Tages als Satz (4 Aufgabe(n) für heute: …. 2 überfällig.), für alle verfolgten Projekte oder eines davon. Ergebnisse: der Satz, die Zahl der heute zu erledigenden und der überfälligen Aufgaben. Schick den Satz als Nachricht oder lass ihn von Gladys sprechen.

Die Felder akzeptieren Szenenvariablen: {{triggerEvent.data.task_id}} markiert die Aufgabe als erledigt, die die Szene ausgelöst hat.

Szenenideen

• Um 7:30 Heutige Vikunja-Aufgaben lesen, dann den Satz per Telegram schicken.
• Vikunja-Erinnerung im Projekt Einkauf: das Flurlicht blinken lassen.
• Eine Taste an der Tür startet Vikunja-Aufgabe erstellen mit Brot kaufen in Einkauf.
• Ein NFC-Tag an den Mülltonnen startet Vikunja-Aufgabe als erledigt markieren mit Müll rausbringen.

Fehlerbehebung

• „Vikunja antwortet nicht“: Prüfe Adresse und Port von der Gladys-Maschine aus (http://<Adresse>:3456 öffnet Vikunja im Browser).
• „API-Token abgelehnt oder ohne eine Berechtigung“: Das Token ist abgelaufen, gelöscht oder falsch kopiert, oder ihm fehlt eine Berechtigung der Liste oben. Vikunja antwortet in allen Fällen gleich: Erstelle ein neues Token mit allen genannten Berechtigungen.
• „Keine Vikunja-API unter dieser Adresse“: Die Adresse antwortet, aber nicht mit der Vikunja-API: Prüfe den Port oder das Pfadpräfix hinter einem Reverse Proxy.
• „Die Adresse leitet um“: Gib die https://-Adresse ein.
• Ein Projekt fehlt: Archivierte Projekte werden nicht verfolgt; ein unter Verfolgte Projekte eingegebener Name ohne passendes Projekt wird ignoriert, und Verbindung testen meldet ihn.
• „Mehrere offene Aufgaben haben diesen Titel“: Gib stattdessen die Nummer an (#12).
• Protokolle: LOG_LEVEL=debug am Container zeigt jede Abfrage.

Grenzen

• Vikunja wird alle 1 bis 10 Minuten gelesen (und zu jeder Fälligkeit, jeder Erinnerung und um Mitternacht): Eine in Vikunja erledigte Aufgabe erscheint innerhalb dieser Zeit in Gladys. Vikunja-Webhooks werden nicht genutzt.
• Zwei Anfragen pro Abfrage (Projekte, offene Aufgaben), plus eine pro weiterer Seite mit 50 Aufgaben. Bis zu 20 Seiten offener Aufgaben werden gelesen.
• Die Integration markiert Aufgaben als erledigt und legt Aufgaben an; sie bearbeitet, löscht, verschiebt oder weist keine zu.
• Getestet mit Vikunja v2.7.0. Die Versionen 0.22 bis 0.24 sollten funktionieren (die Aufgabenliste ist dort /tasks/all und wird genutzt, wenn es /tasks nicht gibt), wurden aber nicht getestet.
• Gladys speichert keine Vikunja-Daten außer /data/vikunja-state.json (die Zeit der letzten Abfrage, damit kein Ereignis doppelt auslöst).
• Nicht mit Vikunja verbunden.

Konfigurationseinstellungen

Diese Einstellungen fragt Vikunja in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Dein Vikunja	section	Nein	Ein selbst gehostetes Vikunja (0.22 oder neuer). Erstelle in Vikunja ein API-Token: Settings, API Tokens, mit den in der Dokumentation genannten Berechtigungen.
Adresse	string	Ja	Adresse von Vikunja, mit https:// für HTTPS und :Port, falls nicht Standard (3456 beim Docker-Image).
API-Token	secret	Ja	Erstellt in Vikunja: Settings, API Tokens. Es beginnt mit tk_.
Optionen	section	Nein
Verfolgte Projekte	string	Nein	Namen oder Nummern, durch Kommas getrennt. Leer: alle Projekte. Ein Gerät pro verfolgtem Projekt.
Selbstsignierte Zertifikate akzeptieren	boolean	Nein	Für eine https://-Adresse mit selbstsigniertem Zertifikat. Nur für deinen eigenen Server aktivieren.
Aktualisierungsintervall	select	Nein	Wie oft Vikunja gelesen wird. Fälligkeiten, Erinnerungen und Mitternacht werden immer pünktlich berücksichtigt.
Sprache der Funktionsnamen	select	Nein	Namen der Funktionen beim Hinzufügen eines Geräts und an Szenen gesendete Texte.

So installierst du Vikunja in Gladys

1. Öffne in Gladys Integrationen: Vikunja 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-vikunja:1.0.1) 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-vikunja.

Vikunja 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

Vikunja 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

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 🙂