ZTD - CLI Task Manager

ZTD is a command-line to-do list manager based on the Zen To Done (ZTD) methodology developed by Leo Babauta.
This tool is designed for productivity and simplicity, with support for priorities, categories, recurring tasks, and more.

---

Features

The app runs in the Command Line Interface (CLI) and has the following features:

• Add tasks with categories (@category), priorities (!urgent), and recurrence (~daily)
• View/sort tasks by category
• Mark tasks as done
• Delete single or multiple tasks
• Set or update priorities, categories, recurrence
• Save/load tasks from JSON file
• Natural language date parsing for scheduling
• For recurring tasks, automatically re-adds recurring tasks (daily/weekly/monthly) on the appropriate date
• When a new task is added, blank [category] and (-) priority spaces are retained to prompt the user to manually add them

---

System Requirements

• Python 3.10 or later
• Operating System: macOS, Windows, or Linux
• Interface: Command Line (Terminal or PowerShell)

---

Privacy and Security

ZTD respects your privacy by storing all task data locally on your device without sharing it externally. For detailed information about data storage, privacy practices, and how to protect your information, please see the PRIVACY.md document.

To learn about security measures, limitations, and options for encrypting your task data, please refer to the SECURITY.md file.

Installation

1. Clone the repository or download the source code.
2. Ensure you have Python 3.10+ installed.
3. (Optional but recommended) Create a virtual environment:

   python -m venv venv
   source venv/bin/activate  # macOS/Linux
   venv\Scripts\activate     # Windows
   

4. Install required third-party tools:

   pip install -r requirements.txt
   

---

Usage

To run the app for the first time, run the following code:

`python 'ZTD_APP_CODE.py'  
`

For usage instructions please refer to HELP.md

---

Dependencies

This project uses the following third-party libraries:

1. schedule

• Copyright: © 2015–present Dan Bader
• Purpose: Handles recurring task scheduling.
• License: MIT License
• Summary: Allows free use, distribution, and modification with attribution.

2. dateparser

• Copyright: © 2014–present Scrapinghub
• Purpose: Parses natural language dates like "next Friday".
• License: BSD 3-Clause License
• Summary: Permits redistribution and modification with credit; no endorsement allowed.

3. rich

• Copyright: © 2020–present Will McGugan
• Purpose: Enhances terminal output with colors, tables, and styled text.
• License: MIT License
• Summary: Permits reuse, modification, and distribution with attribution. Improves user experience in CLI apps.

---

Ethical and Legal Considerations

Here are some of the main ethical and legal considerations for the third party licenses/software used for this tool.

• Open Source Attribution: All third-party libraries selected for this project are open-source and included under valid licenses (MIT, BSD).
• Usage Boundaries: Third party Libraries are used non-commercially and legally, without modification or redistribution outside this project.
• Transparency: This README file includes full disclosure of dependencies and license compliance. This is intended to foster Transparency which is an important ethical principle.

---

Additional Documentation

For more details on privacy and security practices for ZTD, please refer to:

• SECURITY.md — Information about data storage, limitations, and how to encrypt your task data.
• PRIVACY.md — Details on how ZTD stores, deletes, and backs up your data.

---

Thank You

This software was created by Vikashan Thayanithy as part of the CoderAcademy Web Development Bootcamp — Python Module.