Donetick logo

Donetick

Collaborative task and chore management with natural language scheduling

Open-source task manager with natural language input, adaptive scheduling, assignee rotation, gamification, and multi-platform notifications for individuals and groups.

Donetick banner

Overview

Organize Tasks & Chores, Together

Donetick is a self-hosted task and chore management platform built for individuals, families, and shared households. It transforms plain-English descriptions like "Change water filter every 6 months" into fully scheduled, recurring tasks with automatic date and time extraction.

Flexible Scheduling & Collaboration

Support for daily, weekly, monthly, yearly, and adaptive scheduling ensures tasks fit your rhythm. Assignee rotation distributes chores fairly using round-robin, random, or workload-based algorithms. Subtasks break complex jobs into trackable steps, resetting automatically for recurring items. Time tracking, priorities, labels, and photo attachments keep everything organized.

Beyond Tasks: Things, NFC, and Gamification

Track non-task data with "Things"—numbers, booleans, or text—and trigger task completions automatically. Scan NFC tags to mark chores done instantly. A built-in points system and analytics dashboards reward progress and visualize completion trends.

Deploy Anywhere

Run Donetick via Docker, Docker Compose, or standalone binary with SQLite. Integrate with Home Assistant, receive notifications through Telegram, Discord, Pushover, or mobile apps (iOS TestFlight, Android APK). REST API and webhooks enable custom automations. Multi-factor authentication and OAuth2/OIDC support secure your deployment.

Highlights

Natural language task creation with automatic date, time, and recurrence extraction
Adaptive scheduling and assignee rotation (round-robin, random, workload-based)
Things: track non-task data (numbers, booleans, text) and trigger task completions
NFC tag support, gamification points, Home Assistant integration, and multi-platform notifications

Pros

  • Plain-English input eliminates manual date-picking and recurrence configuration
  • Assignee rotation and subtask nesting streamline shared household chores
  • Self-hosted with Docker, Docker Compose, or binary; SQLite backend requires minimal infrastructure
  • REST API, webhooks, and Home Assistant integration enable extensive automation

Considerations

  • Offline support is limited; full functionality requires network connectivity
  • Mobile apps are in alpha (iOS TestFlight) or APK-only (Android); no official app stores yet
  • Photo storage requires external S3-compatible services or local storage (work in progress)
  • Dashboard view and some features are admin-only or require larger screens

Managed products teams compare with

When teams consider Donetick, these hosted platforms usually appear on the same shortlist.

Any.do logo

Any.do

To-do list and task management app for organizing personal tasks, reminders, and schedules

Google Tasks logo

Google Tasks

Simple task & to-do lists integrated with Gmail and Google Calendar

Todoist logo

Todoist

Task & to-do manager with projects, labels, reminders, and AI assist

Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.

Fit guide

Great for

  • Families and roommates coordinating recurring chores with fair workload distribution
  • Self-hosters seeking a privacy-focused, extensible task manager with API access
  • Home Assistant users wanting unified task management across smart home dashboards
  • Teams needing natural language scheduling and time tracking for shared responsibilities

Not ideal when

  • Users requiring fully offline-capable mobile apps without network dependency
  • Organizations needing enterprise SSO beyond OAuth2/OIDC or advanced role-based permissions
  • Teams expecting native iOS/Android apps from official app stores immediately
  • Projects requiring built-in cloud storage without configuring S3-compatible providers

How teams use it

Shared Household Chore Rotation

Automatically rotate trash, dishes, and cleaning tasks among roommates using round-robin assignment, ensuring fair distribution and reducing disputes.

Home Maintenance Tracking

Schedule HVAC filter changes, lawn care, and appliance servicing with adaptive recurrence that learns from completion history and sends Telegram reminders.

Wall-Mounted Family Dashboard

Mount a tablet displaying Donetick's dashboard view so any family member can scan NFC tags or tap tasks to mark chores complete in real time.

Home Assistant Task Automation

Sync Donetick tasks into Home Assistant to-do lists, trigger smart home routines when chores are completed, and view progress on existing dashboards.

Tech snapshot

Go100%
Dockerfile1%

Tags

gotask-managerreacttasksgolangdockerchoretodolistselfhosted

Frequently asked questions

How does natural language task creation work?

Type phrases like 'Take the trash out every Monday and Tuesday at 6:15 pm' and Donetick extracts dates, times, and recurrence patterns automatically, creating a fully scheduled task without manual configuration.

What are Things and how do they differ from tasks?

Things track non-task data—numbers, booleans, or text—like water meter readings or thermostat settings. You can configure tasks to auto-complete when a Thing reaches a specific value.

Can I run Donetick without Docker?

Yes. Download the standalone binary from the Releases page, create a selfhosted.yaml configuration file, and run it with DT_ENV=selfhosted. SQLite is the default database.

Which notification channels are supported?

Donetick sends notifications via mobile apps (iOS TestFlight, Android APK), Telegram, Discord, and Pushover. Webhooks enable custom integrations with other services.

How do I integrate Donetick with Home Assistant?

Install the official Donetick Home Assistant integration. It creates separate to-do lists for each user, syncs tasks in real time, and allows task management directly within Home Assistant dashboards.

Project at a glance

Active
Stars
1,724
Watchers
1,724
Forks
105
LicenseAGPL-3.0
Repo age1 year old
Last commit11 hours ago
Self-hostingSupported
Primary languageGo

Last synced 3 hours ago