explaingit

tednv/vikunja-task-hub

Analysis updated 2026-05-18

2JavaScriptAudience · generalComplexity · 3/5Setup · moderate

TLDR

A Home Assistant dashboard card that lets you view, organize, and manage your Vikunja tasks and projects without leaving your smart home dashboard.

Mindmap

mindmap
  root((Vikunja Task Hub))
    What it does
      Manage tasks
      Organize projects
      Bulk actions
    Tech stack
      JavaScript
      Home Assistant
      Vikunja API
    Use cases
      Daily task tracking
      Recurring tasks
      File attachments
    Audience
      Home Assistant users
      Vikunja users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Manage your Vikunja projects and tasks directly from a Home Assistant dashboard without opening a separate app.

USE CASE 2

Bulk move, categorize, complete, or delete many tasks at once across projects.

USE CASE 3

Set up recurring tasks and track them with due dates and Markdown notes.

USE CASE 4

Attach photos, videos, or files to a task using your phone's camera.

What is it built with?

JavaScriptHome AssistantHACSVikunja API

How does it compare?

tednv/vikunja-task-hub3imed-jaberi/cryptography-si-isamm3imed-jaberi/koa-isomorphic-router
Stars222
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-09-252021-02-06
MaintenanceDormantDormant
Setup difficultymoderateeasyeasy
Complexity3/51/52/5
Audiencegeneralresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a running Vikunja instance and a Home Assistant setup with HACS support.

In plain English

Vikunja Task Hub is a custom card for Home Assistant, the home automation platform, that lets you manage tasks and projects from Vikunja, a separate task and project management tool, right inside your Home Assistant dashboard. Instead of switching to another app, you see your projects, categories, and tasks in a card built for that dashboard. The card shows every project and task that your configured Vikunja account can access. You can switch between projects or categories, search task titles as you type, and keep finished tasks tucked away in a separate section so they do not clutter your view. Selecting several tasks at once lets you move them to a new or existing project, add or remove categories, mark them complete or active, or delete them after a confirmation step. Opening a single task gives you a fuller editor. You can write descriptions with Markdown formatting, preview them before saving, set due dates, and set up recurring schedules such as daily, weekly, monthly, or custom intervals. Repeating tasks show a small marker in the list so you can tell them apart from one time tasks. You can also attach files to a task, including photos or videos captured directly from a supported device, with a documented 20 megabyte limit per file. To use it you need a working Home Assistant setup that supports custom integrations and dashboard resources, plus a reachable Vikunja instance with its API turned on and an API token with the right permissions. Installation happens through HACS, a community add on manager for Home Assistant, or by copying the files into your configuration folder manually and restarting Home Assistant. The interface is translated into more than two dozen languages and follows whatever language Home Assistant itself is set to, falling back to English if a translation is not available yet. This is an independent community project, not something built or endorsed by the Vikunja or Home Assistant teams.

Copy-paste prompts

Prompt 1
Help me install the Vikunja Task Hub custom card in Home Assistant using HACS.
Prompt 2
Show me how to configure a Vikunja API token for use with Vikunja Task Hub.
Prompt 3
Write a Lovelace dashboard layout that includes Vikunja Task Hub alongside my other Home Assistant cards.
Prompt 4
Explain how to set up a recurring weekly task in Vikunja Task Hub.

Frequently asked questions

What is vikunja-task-hub?

A Home Assistant dashboard card that lets you view, organize, and manage your Vikunja tasks and projects without leaving your smart home dashboard.

What language is vikunja-task-hub written in?

Mainly JavaScript. The stack also includes JavaScript, Home Assistant, HACS.

How hard is vikunja-task-hub to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is vikunja-task-hub for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.