https://github.com/harishrajt/pomodoro_timer

A simple Pomodoro timer application built with Python's tkinter library to enhance productivity. It features a user-friendly GUI that allows users to manage work sessions of 25 minutes followed by breaks. The app visually displays the countdown timer and tracks completed sessions with check marks, promoting effective time management and motivation.
https://github.com/harishrajt/pomodoro_timer

python tkinter-gui

Last synced: 4 months ago
JSON representation

A simple Pomodoro timer application built with Python's tkinter library to enhance productivity. It features a user-friendly GUI that allows users to manage work sessions of 25 minutes followed by breaks. The app visually displays the countdown timer and tracks completed sessions with check marks, promoting effective time management and motivation.

• Host: GitHub
• URL: https://github.com/harishrajt/pomodoro_timer
• Owner: harishrajT
• Created: 2024-10-15T15:41:08.000Z (9 months ago)
• Default Branch: master
• Last Pushed: 2024-10-15T15:45:33.000Z (9 months ago)
• Last Synced: 2025-01-07T21:16:36.843Z (6 months ago)
• Topics: python, tkinter-gui
• Language: Python
• Homepage:
• Size: 13.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Pomodoro Timer

This is a simple Pomodoro Timer application built using Python's Tkinter library. The Pomodoro technique is a time management method that breaks down work into intervals, traditionally 25 minutes in length, separated by short breaks.

## Features

- **Work Timer:** Default set to 25 minutes.

- **Short Break Timer:** Default set to 5 minutes.

- **Long Break Timer:** Default set to 20 minutes after 4 work intervals.

- **Start and Reset Buttons:** Easily start the timer or reset it.

- **Progress Checkmarks:** Track work intervals with checkmarks after each work session.

## How to Run

1. **Requirements:**  

   - You need to have Python installed on your system. Tkinter is part of the standard Python distribution, so no extra packages are required.

   - You need an image named `tomato.png` to display the visual in the UI (place it in the same directory as the script).

2. **Running the Application:**  

   - Simply run the `pomodoro.py` file.

   - The timer will start with a 25-minute work session, followed by short breaks, and a long break every 4 work intervals.

## Code Overview

### Main Components:

- **UI Setup:**

  The interface is created using Tkinter's `Canvas`, `Label`, and `Button` widgets to display the timer, start/reset buttons, and checkmarks.

  

- **Timer Mechanism:**

  - `start_timer()`: Manages the start of each work or break session based on the number of intervals completed.

  - `count_down()`: Manages the countdown for each session, updating the timer display every second.

- **Reset Function:**

  - `reset_timer()`: Cancels the current timer and resets the interface to its initial state.

## Customization

You can customize the time intervals by changing the following constants in the script:

- `WORK_MIN`: Work duration in minutes (default is 25).

- `SHORT_BREAK_MIN`: Short break duration in minutes (default is 5).

- `LONG_BREAK_MIN`: Long break duration in minutes (default is 20).

## Screenshot

Include a screenshot of the running application if possible.

## License

feel free to modify and distribute it.