Skip to content

README.md

Latest commit

 

History

History
99 lines (70 loc) · 2.84 KB

README.md

File metadata and controls

99 lines (70 loc) · 2.84 KB

⏰ Daily Time & Productivity Tracker

Python Version

A Python CLI application for tracking tasks, time management, and productivity analysis with visual reports.

✨ Features

  • Task Management: Add, edit, delete, and search tasks
  • Time Tracking: Flexible duration input (e.g., "2h 30m", "150m", "2.5h")
  • Focus Scoring: Rate focus level (1-10) for each task
  • Categories: Organize tasks by custom categories
  • Reports & Charts: Daily/weekly summaries with matplotlib visualizations
  • Search & Filter: Find tasks by date, category, focus score, or notes
  • SQLite Database: Reliable local storage

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/debugfest/productivity-tracker.git
cd productivity-tracker

# Create virtual environment (optional)
python -m venv venv
# Windows: venv\Scripts\activate
# macOS/Linux: source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the application
python main.py

Demo

python demo.py

📖 Usage

Main Menu Options:

  • Add, edit, delete, and list tasks
  • View daily/weekly summaries
  • Generate reports and charts
  • Search and filter tasks

Adding a Task: Enter task name, category, duration (e.g., "2h 30m"), focus score (1-10), and optional notes.

Reports: Generate various charts including weekly time distribution, category breakdowns, focus trends, and productivity heatmaps.

🏗️ Project Structure

├── main.py              # CLI entry point and user interface
├── tracker.py           # Task data model and database operations
├── report.py            # Report generation and matplotlib visualizations
├── utils.py             # Utility functions, validation, and formatting
├── demo.py              # Demo script with sample data
├── requirements.txt     # Python dependencies
├── data/time_log.db     # SQLite database (auto-created)
└── reports/             # Generated reports and charts

🐛 Troubleshooting

Common Issues:

  • Database errors: Ensure write permissions in the project directory
  • Matplotlib issues: Install matplotlib[all] or run pip install -r requirements.txt
  • Import errors: Verify Python version is 3.8+

Duration Format Examples:

  • "2h 30m", "150m", "2.5h" are all valid
  • Focus score must be between 1-10
  • Task name cannot be empty

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Quick Start:

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push and open a Pull Request

Acknowledgments: Matplotlib and SQLite

Made with ❤️ for productivity optimization ⏰📊