At a Glance:
Donetick is an open-source task and chore management app with natural language task creation, flexible scheduling, assignee rotation, and multi-platform notifications, designed for collaborative household use and self-hosted deployment.
Overview:
Donetick is an open-source task and chore management application built for collaborative use among family members, friends, or small groups. It allows users to create, assign, and track recurring tasks and chores with advanced scheduling options, including natural language parsing and assignee rotation. The app supports shared group organization through labels and priorities, and includes features like subtasks, time tracking, NFC tag triggers, and a points-based gamification system. Donetick offers web-based access with a dashboard view, a REST API, webhook support, and integrations with Home Assistant and external notification services. A single-circle instance mode is available for self-hosted single-household deployments.
Key Decision Points:
Self-Hosted Single-Household Mode: Supports a dedicated single-circle instance mode that hides group management UI and uses OIDC groups for role assignment, making it suitable for private, self-hosted family deployments.
Collaborative Task Sharing: Tasks and chores are created within groups called circles, and assignments can be rotated automatically using round-robin, random, or fewest-completions logic.
Natural Language Input: Tasks can be created using plain English phrases that are automatically parsed for dates, times, and recurrence patterns, reducing manual scheduling effort.
Developer and Integration APIs: Provides a full REST API and a webhook system for custom automations, along with an official Home Assistant integration and multi-platform notification channels.
Cloud and Local Photo Storage: Task attachments can be stored using local storage or S3-compatible cloud providers like AWS S3, Cloudflare R2, and MinIO.
Core Features:
Natural Language Task Creation: Parses plain English descriptions to automatically extract due dates, times, and recurring schedules.
Advanced Recurrence and Adaptive Scheduling: Supports fixed and adaptive scheduling, where the system learns from historical completion patterns to suggest future due dates, plus due-date-based or completion-date-based recurrence options.
Assignee Rotation: Automatically rotates task assignments among group members based on a round-robin order, at random, or by selecting the person with the fewest completed tasks.
Smart Subtask Reset: Subtasks on recurring tasks automatically reset when the main task is marked complete, and subtasks can be nested.
Things Tracking: Non-task data points, such as numbers, booleans, or text, can be tracked and can automatically mark associated tasks as complete upon value changes.
Multi-Factor Authentication and OIDC Support: Supports TOTP-based MFA and sign-in through any OAuth2 provider with OIDC, such as Authentik, Keycloak, and Authelia.
Use Cases:
Families or housemates managing shared household chores with automatic task rotation and multi-platform reminders.
Self-hosters setting up a private, single-household task board with admin roles managed through an OIDC identity provider.
Developers automating task management workflows using the REST API, webhooks, and Home Assistant integration.
Open-Source Alternative Value:
Donetick provides a self-hostable task management system with collaborative features suited for small groups. It offers control over access and roles through OIDC integration, especially in single-circle instance mode where group management is hidden from end users. The ability to extend functionality through a REST API, webhooks, a dedicated Home Assistant integration, and notification channels like Telegram and Discord allows users to adapt the app to their specific environment without relying on external commercial platforms.
