Pomodoro Timer (Java Swing)

A simple Pomodoro Timer desktop application built with Java and Swing.
It helps improve productivity by following the Pomodoro Technique: focused work sessions followed by short breaks.

Screenshot

---

Features

• 25-minute Pomodoro timer
• 5-minute short break
• 30-minute long break every 4 Pomodoros
• Pause and resume timer
• Reset session counters
• Sound notification when a session ends
• Mute option for the alarm
• Counters for completed Pomodoros and breaks

---

How it works

1. Press Start to begin a Pomodoro session (25 minutes).
2. When the session finishes, an alarm sound will play.
3. Press Break to start a short break.
4. After every 4 completed Pomodoros, the break becomes a long break (30 minutes).
5. Use Pause to temporarily stop the timer and Reset to restart everything.

---

Controls

• Start – Starts a 25-minute Pomodoro work session.
• Break – Starts a break. Every 4 completed Pomodoros, the break becomes a long break (30 minutes).
• Pause – Pauses or resumes the current timer.
• Reset – Stops the timer and resets all counters and timers.
• Mute – Stops the alarm sound when a session finishes.

---

Technologies used

• Java
• Java Swing (GUI)
• Java Timer
• Java Sound API

---

Project structure

PomodoroTimer
│
├─ src
│ ├─ App.java
│ ├─ Gui.java
│ └─ resources
│ ├─ icon.png
│ └─ time-up.wav
│
├─ docs
│ └─ screenshot.png
│
├─ icon.png
├─ icon.ico
├─ manifest.txt
├─ README.md
└─ .gitignore

• App.java – application entry point
• Gui.java – graphical user interface and timer logic
• icon.png – app icon
• time-up.wav – alarm sound played when a timer finishes

---

How to run

Run with Java

java -jar PomodoroTimer.jar

Requires Java 17+.

Install on Linux (Debian / Ubuntu / Linux Mint)

sudo apt install ./pomodorotimer_1.0_amd64.deb

After installation, the application will appear in the system menu.

Install on Windows

execute PomodoroTimer-1.0.exe

After installation, the application will appear in the system menu.

IDE

Run the project directly from your IDE (Eclipse, IntelliJ, VS Code, etc.).

---

Author

Daniel Pacheco