🗂️ Task Manager (CLI Edition)

A simple yet powerful command-line task management system built with Python.
Easily add, modify, complete, delete, and view tasks — all from your terminal.

---

📘 Project Overview

This Task Manager CLI is a Python-based personal productivity tool that helps you manage your daily to-do items from the command line. It automatically adjusts task priorities as deadlines approach and stores all data locally in a tasks.json file, so your progress is always saved between sessions.

---

⚙️ Features

• ✅ Add New Tasks with title, description, priority, and due date/time
• ✏️ Modify Existing Tasks (title, due date, description, or priority)
• 📅 Automatic Priority Adjustment as deadlines approach
• ✔️ Mark Tasks as Complete
• 🗑️ Delete Tasks (with confirmation prompts)
• 📜 View All Tasks sorted by priority and due date
• 💾 Persistent Storage using JSON (no external database required)
• 🔊 Audio Feedback for errors and successes (cross-platform support)

---

🧩 Folder Structure

TaskManager/
│
├── task_manager.py     # Main script (this file)
├── README.md           # Project documentation
└── LICENCE             # MIT Licence

---

🚀 How to Run

1. Make sure you have Python 3.13 or above installed.
2. Download or clone this repository:

   git clone https://github.com/Sheikh-H/TaskManager.git

3. Navigate into the project folder:

   cd TaskManager

4. Run the program:

   python task_manager.py

---

🖥️ Usage Guide

Once you run the program, the main menu will appear with the following options:

1. Add New Task
2. Modify a Task
3. Mark Task as Complete
4. Delete a Task
5. View All Tasks
6. Close Application

Type the number corresponding to your choice, and follow the prompts. When adding tasks, you can type menu at any time to abort and return to the main menu.

---

📂 Data Storage

All tasks are stored in tasks.json automatically. Example structure:

{
  "tasks": [
    {
      "id": 1,
      "title": "Complete Project",
      "priority": "High",
      "description": "Finish Python CLI task manager",
      "due_date": "26-10-2025 14:00",
      "completed": false
    }
  ]
}

---

🧠 Priority System

The program uses an automatic priority adjustment system:

• 📅 1 Day before due date: Priority increases by 1 level
• ⏰ 1 Hour before due date: Priority increases again by 1 level (max = High)

---

🔊 Platform Compatibility

The script runs on:

• 🪟 Windows (with sound via winsound)
• 🐧 Linux & macOS (with ASCII bell alerts)

---

🧰 Requirements

• Python 3.13 or above
• No external libraries required — fully built using Python’s standard library

---

📄 Licence

This project is licenced under the MIT Licence — see the LICENCE file for details.

MIT Licence

Copyright (c) 2025 Sheikh-H

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---

💡 Author

👤 Sheikh
💬 Learning to Code | Passionate about building clean, functional tools in Python
📧 Contact: https://www.linkedin.com/in/sheikh-hussain/

---

⭐ If you like this project, please give it a star on GitHub!