Skip to content

Minimal Tkinter Pomodoro timer with start/reset controls, short/long breaks, and progress check marks.

Notifications You must be signed in to change notification settings

AliCodesDev/pomodoro-timer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

README.md

# Pomodoro Timer ⏱️🍅 (Tkinter)

A desktop Pomodoro timer built with Tkinter. It cycles through 25-minute work sessions, 5-minute short breaks, and a 20-minute long break every 4 work blocks. Progress is shown with check marks, and you can reset at any time.

## Features
- 25/5/20 Pomodoro schedule (configurable)
- Start/Reset controls
- Visual timer overlayed on a tomato image
- Session progress via ✔ marks

## Requirements
- Python 3.8+
- Tkinter (bundled with the standard Python installer)
- `tomato.png` in the project root

## Usage
```bash
python main.py

Configuration

Edit these constants at the top of main.py:

WORK_MIN = 25
SHORT_BREAK_MIN = 5
LONG_BREAK_MIN = 20

You can also tweak colors and font:

PINK = "#e2979c"
RED = "#e7305b"
GREEN = "#9bdeac"
YELLOW = "#f7f5dd"
FONT_NAME = "Courier"

Project Structure

pomodoro/
├─ main.py
└─ tomato.png

Notes

  • On macOS, if the window doesn’t appear, ensure your Python includes Tk (use the installer from python.org).
  • The UI uses window.after(...) for a non-blocking countdown; reset_timer() cancels the scheduled callback safely.

About

Minimal Tkinter Pomodoro timer with start/reset controls, short/long breaks, and progress check marks.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages