tududi: Self-Hosted Task Management for Privacy, Control, and Efficiency

Introduction

tududi is an open-source, self-hosted task management application that blends the simplicity required for personal use with the robust features needed for professional project organization. Built with privacy, control, and efficiency in mind, it empowers users to manage tasks, projects, areas, notes, and tags in a highly organized manner. Whether you're an individual looking to streamline your daily workflow or a team seeking a collaborative and private project management tool, tududi offers a flexible and powerful solution.

Key features include a clear hierarchical structure, intelligent recurring tasks, subtasks with progress tracking, multi-language support, and seamless integration with Telegram for quick task capture and daily digests. Its open API further allows for extensive customization and integration with other tools.

Installation

Getting started with tududi is straightforward, especially using Docker. The following quick start command will pull the latest image and run the application, setting up an initial admin user and persistent volumes for your data.

docker pull chrisvel/tududi:latest

docker run \
  -e TUDUDI_USER_EMAIL=admin@example.com \
  -e TUDUDI_USER_PASSWORD=your-secure-password \
  -e TUDUDI_SESSION_SECRET=$(openssl rand -hex 64) \
  -v ~/tududi_db:/app/backend/db \
  -v ~/tududi_uploads:/app/backend/uploads \
  -p 3002:3002 \
  -d chrisvel/tududi:latest

After running the command, navigate to http://localhost:3002 in your web browser and log in with the credentials you provided.

For detailed setup instructions, including reverse proxy configurations and development setup, refer to the official documentation.

Examples

tududi provides a comprehensive REST API, allowing for integration with external tools and automation workflows. Here are quick examples of how to interact with the API using curl to retrieve and create tasks.

First, ensure you have generated a personal API key through the tududi web interface for secure access.

Get all tasks:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     http://localhost:3002/api/v1/tasks

Create a new task:

curl -X POST \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"name":"Complete API documentation","priority":"medium"}' \
     http://localhost:3002/api/v1/task

The API supports complete CRUD operations for tasks, projects, notes, and areas, along with features for recurring tasks, subtasks, and tag management. Full API documentation is available at /api-docs after authentication.

Why Use tududi?

tududi stands out as a powerful task and project management solution for several compelling reasons:

• Privacy and Control: Being self-hosted, tududi gives you complete ownership and control over your data, ensuring privacy without reliance on third-party cloud services.
• Comprehensive Features: From basic task creation to complex recurring tasks, subtasks, project sharing, notes, tags, and area categorization, tududi covers all aspects of personal and team productivity.
• Smart Recurring Tasks: Its advanced system for recurring tasks, including multiple patterns, completion-based recurrence, and smart parent-child linking, simplifies routine management.
• Seamless Integrations: With Telegram integration for quick capture and daily digests, plus an open API for custom automations, tududi fits into diverse workflows.
• Multi-Language Support: Available in 24 languages, it offers a truly global and accessible productivity experience.
• Active Development & Community: The project is actively maintained, with a clear roadmap and a welcoming community for contributions and support.

Links

• GitHub Repository: https://github.com/chrisvel/tududi
• Official Documentation: https://docs.tududi.com
• Designing a Life Management System That Doesn't Fight Back: https://medium.com/@chrisveleris/designing-a-life-management-system-that-doesnt-fight-back-2fd58773e857
• From Task to Table: How I Finally Got to the Korean Burger: https://medium.com/@chrisveleris/from-task-to-table-how-i-finally-got-to-the-korean-burger-01245a14d491
• Discord Community: https://discord.gg/fkbeJ9CmcH
• Reddit Community: https://www.reddit.com/r/tududi/