Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation


README.md

🍅 Modern Pomodoro Timer (Tkinter)

A clean, modern, and fully animated Pomodoro Timer built with Python and Tkinter, featuring a rounded UI, dark/light mode toggle, custom timer settings, progress animations, sound alerts, and productivity statistics.

This project demonstrates advanced Tkinter GUI design, image rendering, animations, and interactive timer logic.


🚀 Features

🎨 Modern Rounded UI

  • Smooth shadows & hover effects
  • Dark/Light theme toggle
  • Minimal and distraction-free layout

🍅 Tomato-Centered Timer

  • Timer positioned perfectly inside the tomato
  • Pulse animation while running
  • Adjustable vertical alignment

⏱ Custom Timer Settings

Users can set:

  • Work duration
  • Short break
  • Long break
  • Apply instantly

▶️ Timer Controls

  • Start
  • Pause / Resume
  • Reset

🔊 Sound Alerts

Three-tone alert at the end of each session (with cross-platform fallback).

📈 Productivity Statistics

  • Work sessions completed
  • Break sessions completed
  • Total focus minutes
  • Small animated “bounce” increment effect

🌀 Animated Progress Arc

Circular progress animation rendered around the tomato.


📂 Project Structure


pomodoro-timer/
│
├── main.py                # Main Tkinter application
├── README.md              # Documentation
├── LICENSE                # MIT License
└── assets/
└── tomato.png         # Tomato image used in the UI


🛠 Installation

1. Clone the repository

git clone https://github.com/yourusername/pomodoro-timer.git
cd pomodoro-timer

2. Install requirements

pip install pillow

Tkinter comes preinstalled on Windows & macOS. Linux users may need to install it using: sudo apt install python3-tk

3. Run the app

python main.py

📘 Requirements

  • Python 3.8+
  • Pillow (pip install pillow)
  • Tkinter (built-in)

📄 License

This project is licensed under the MIT License. You are free to use, modify, and distribute the software.


💡 Future Enhancements

  • Animated charts for statistics
  • Multiple themes
  • Desktop notifications
  • To-Do list integration

✨ Author

Shubham Jaju


About

A modern, animated Pomodoro Timer built with Tkinter—featuring dark/light mode, custom timer settings, progress arc, pulse animation, statistics tracking, and a clean rounded UI inspired by modern productivity tools.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages