← Back to Projects
MkViewer - PomodoroTimer [Read-Only]
Initializing MkViewer...
README.md

Project 28 - Pomodoro Timer ⏳🍅

(readme generated using AI)

A simple and effective Pomodoro Timer desktop application built with Python and Tkinter. This project is designed to help users improve focus and productivity using the Pomodoro Technique — a time-management method based on focused work sessions and timed breaks.


📌 What This Project Does

This app cycles through work sessions and breaks automatically: - 25 minutes of focused work - 5-minute short breaks - 20-minute long break after every 4 work sessions
It visually displays the countdown timer and tracks completed work sessions using check marks.

This project was built as part of a learning exercise to practice: - GUI development with Tkinter
- Timers and event loops
- State tracking with global variables
- Basic project structure and debugging


🛠️ Features

  • ✅ 25-minute work timer
  • ✅ 5-minute short breaks
  • ✅ 20-minute long breaks
  • ✅ Automatic session switching
  • ✅ Visual countdown display
  • ✅ Session progress tracking with ✔ marks
  • ✅ Reset button to restart the cycle
  • ✅ Clean and user-friendly UI
  • ✅ Tomato graphic for classic Pomodoro design

🖥️ Technologies Used

  • Python
  • Tkinter (GUI Framework)
  • Math Library

▶️ How To Run

  1. Make sure you have Python 3.x installed.
  2. Place a tomato.png image in the same folder as the script.
  3. Run the file using: bash python main.py
  4. Click Start to begin the Pomodoro cycle.
  5. Click Reset anytime to restart the timer.