https://github.com/peter-l-svk/pomodoro-timer
Pomodoro Timer app in Python3 and tkinter-gui libs.
https://github.com/peter-l-svk/pomodoro-timer
pomodoro-timer python python-3 python3 timer-app timer-application tkinter tkinter-app tkinter-gui tkinter-python
Last synced: 11 months ago
JSON representation
Pomodoro Timer app in Python3 and tkinter-gui libs.
- Host: GitHub
- URL: https://github.com/peter-l-svk/pomodoro-timer
- Owner: Peter-L-SVK
- License: mit
- Created: 2025-07-04T17:59:48.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-04T18:39:25.000Z (11 months ago)
- Last Synced: 2025-07-04T19:19:42.147Z (11 months ago)
- Topics: pomodoro-timer, python, python-3, python3, timer-app, timer-application, tkinter, tkinter-app, tkinter-gui, tkinter-python
- Language: Python
- Homepage:
- Size: 125 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pomodoro Timer with Task Management
A productivity application combining the Pomodoro technique with task management, designed for Linux (Fedora Cinnamon) with a clean, minimalist interface.
## Features
- **Pomodoro Timer**
- 25-minute work sessions
- 5-minute short breaks
- 15-minute long breaks after 4 sessions
- Visual circular progress indicator
- Configurable timer durations
- **Task Management**
- Add/edit/delete tasks
- Mark tasks as completed
- Set current focus task
- Task completion statistics
- Persistent task storage
- **Productivity Tools**
- Break reminders (posture/stretch alerts)
- Sound notifications
- Visual completion tracking
- Session statistics
## Installation
### Requirements
- Python 3.x
- Tkinter
- Fedora/Cinnamon (or compatible Linux distro)
```bash
# Clone repository
git clone https://github.com/yourusername/pomodoro-timer.git
cd pomodoro-timer
# Install dependencies - Fedora
sudo dnf install python3-tkinter alsa-utils pulseaudio-utils libnotify
#Ubuntu/Mint
sudo apt install python3-tk
# Run the application
python3 pomodoro.py #or ./pomodoro.py
```
## Usage
1. **Timer Tab**:
- Start/Pause/Reset timer
- View current task
- See completion progress
- Adjust timer settings
2. **Tasks Tab**:
- Add new tasks with `Enter task...` placeholder
- Set current task
- Delete tasks
- View completion statistics
3. **Menu**:
- Toggle break reminders
- Configure notification sounds
## Configuration
Modify timer durations in the Settings section:
- Work time (default: 25 min)
- Short break (default: 5 min)
- Long break (default: 15 min)
Choose notification sounds:
- System beep
- Bell sound
- Full alert (visual+audio)
## Troubleshooting
**Sound not working?**
```bash
sudo dnf install alsa-utils pulseaudio-utils
# Ubuntu/Mint
sudo apt install pulseaudio-utils alsa-utils
```
Note: Note: Ubuntu/Mint typically include PulseAudio by default, but these ensure CLI tools are installed.
**Missing fonts?**
```bash
sudo dnf install google-noto-sans-fonts
#Ubuntu/Mint
sudo apt install libnotify-bin
```
**Window not displaying properly?**
Try running with basic theme:
```python
self.style.theme_use("default") # Change in code
```
## License
MIT License - Free for personal and commercial use
---
*Adapt the Pomodoro durations and notification preferences to match your workflow!*