Skip to content

coderbri/28_Pomodoro_Timer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

28 Pomodoro Timer

A simple yet functional Pomodoro Timer built with Python's Tkinter GUI library. This app helps users stay productive by alternating between focused work sessions and timed breaks following the Pomodoro Technique.

Pomodoro Timer UI.
Classic tomato timer layout built using Tkinter's Canvas and grid system.

✑ Overview

The Pomodoro Technique is a time management method that breaks work into focused intervals (typically 25 minutes), separated by short breaks.
This app automates that cycle — tracking work sessions, initiating breaks, and displaying completion checkmarks to help users visualize their progress.


✧ Features

  • 🧠 Work & Break Cycles: Automatically alternates between work sessions, short breaks, and long breaks.
  • 🔁 Automatic Transitions: Seamlessly starts the next session without manual input.
  • 🔔 Reset Functionality: Instantly stop and reset the timer and session progress.
  • ✔️ Progress Tracking: Displays checkmarks after each completed work session.
  • 🎨 Custom UI: Built with a tomato-themed design and styled using Tkinter’s Canvas and Label widgets.
  • 🪶 Lightweight & Responsive: Minimal dependencies — runs on any system with Python installed.

⚃ Tech Stack

  • Language: Python 3.x
  • GUI Framework: Tkinter (standard Python library)
  • Math Library: math for time conversion
  • Assets: Custom tomato image (tomato.png) for theme aesthetics

⚙ Installation & Setup

  1. Clone this repository.

  2. Run the application:

    python main.py
  3. Make sure the tomato.png image is in the same directory as main.py.


✒︎ How to Use

  1. Click Start to begin the Pomodoro cycle.
  2. The timer will begin counting down from 25 minutes (default).
  3. When a session ends, the app automatically transitions to a break.
  4. Each completed work session adds a ✔️ mark below the timer.
  5. Press Reset anytime to restart the timer and clear progress.

coderBri © 2025

About

A simple yet functional Pomdoro Timer built with Python's Tkinter GUI library.

Resources

Stars

Watchers

Forks

Languages