Customizable pomodoro timer

A command-line python application that implements a structured and customizable pomodoro timer with multiple themes, session handling, and robust input validation.

---

Features

• Multiple theme modes:

  • Classic
  • Soft study
  • Focus mode
  • Late-night workflow
  • Cozy desk
  • Monochrome minimal

• Predefined timer configurations:

  • 25 minutes work / 5 minutes break
  • 30 minutes work / 5 minutes break
  • 50 minutes work / 10 minutes break

• Fully customizable timer:

  • User-defined hours, minutes, and seconds for both study and break durations

• Session-based execution:

  • Supports multiple consecutive study sessions in a single run

• Centralized timer logic:

  • Reusable core function reduces redundancy and improves scalability

• Strong input validation:

  • Ensures only valid numeric inputs are accepted
  • Handles invalid entries using exception handling and loops

• Interactive CLI interface:

  • Structured prompts and clean output flow

---

How to run

python pomodoro_timer_v1.py

---

Project structure

• pomodoro_timer_v1.py → main application file

---

Concepts demonstrated

• Modular programming using functions
• Control flow (loops and conditionals)
• Input validation with try-except blocks
• Time-based execution using the time module
• Code reusability and abstraction

---

Future improvements

• Persistent session tracking using file handling
• Sound/notification integration
• Menu-driven navigation system
• Graphical user interface (GUI) version

---

Preview

---

Notes

This project is part of a broader effort to build structured, user-interactive command-line applications while strengthening core python fundamentals.