{"id":29345579,"url":"https://github.com/peter-l-svk/pomodoro-timer","last_synced_at":"2025-07-08T15:28:49.771Z","repository":{"id":302916515,"uuid":"1013930035","full_name":"Peter-L-SVK/pomodoro-timer","owner":"Peter-L-SVK","description":"Pomodoro Timer app in Python3 and tkinter-gui libs.","archived":false,"fork":false,"pushed_at":"2025-07-04T18:39:25.000Z","size":128,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-04T19:19:42.147Z","etag":null,"topics":["pomodoro-timer","python","python-3","python3","timer-app","timer-application","tkinter","tkinter-app","tkinter-gui","tkinter-python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Peter-L-SVK.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-04T17:59:48.000Z","updated_at":"2025-07-04T18:39:28.000Z","dependencies_parsed_at":"2025-07-05T14:30:22.949Z","dependency_job_id":null,"html_url":"https://github.com/Peter-L-SVK/pomodoro-timer","commit_stats":null,"previous_names":["peter-l-svk/pomodoro-timer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Peter-L-SVK/pomodoro-timer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Peter-L-SVK%2Fpomodoro-timer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Peter-L-SVK%2Fpomodoro-timer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Peter-L-SVK%2Fpomodoro-timer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Peter-L-SVK%2Fpomodoro-timer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Peter-L-SVK","download_url":"https://codeload.github.com/Peter-L-SVK/pomodoro-timer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Peter-L-SVK%2Fpomodoro-timer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264295475,"owners_count":23586525,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["pomodoro-timer","python","python-3","python3","timer-app","timer-application","tkinter","tkinter-app","tkinter-gui","tkinter-python"],"created_at":"2025-07-08T15:28:46.636Z","updated_at":"2025-07-08T15:28:49.765Z","avatar_url":"https://github.com/Peter-L-SVK.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pomodoro Timer with Task Management\n\n![Pomodoro Timer Screenshot](demo.png)\n\nA productivity application combining the Pomodoro technique with task management, designed for Linux (Fedora Cinnamon) with a clean, minimalist interface.\n\n## Features\n\n- **Pomodoro Timer**\n  - 25-minute work sessions\n  - 5-minute short breaks\n  - 15-minute long breaks after 4 sessions\n  - Visual circular progress indicator\n  - Configurable timer durations\n\n- **Task Management**\n  - Add/edit/delete tasks\n  - Mark tasks as completed\n  - Set current focus task\n  - Task completion statistics\n  - Persistent task storage\n\n- **Productivity Tools**\n  - Break reminders (posture/stretch alerts)\n  - Sound notifications\n  - Visual completion tracking\n  - Session statistics\n\n## Installation\n\n### Requirements\n- Python 3.x\n- Tkinter\n- Fedora/Cinnamon (or compatible Linux distro)\n\n```bash\n# Clone repository\ngit clone https://github.com/yourusername/pomodoro-timer.git\ncd pomodoro-timer\n\n# Install dependencies - Fedora\nsudo dnf install python3-tkinter alsa-utils pulseaudio-utils libnotify\n\n#Ubuntu/Mint \nsudo apt install python3-tk\n\n# Run the application\npython3 pomodoro.py #or ./pomodoro.py\n```\n\n## Usage\n\n1. **Timer Tab**:\n   - Start/Pause/Reset timer\n   - View current task\n   - See completion progress\n   - Adjust timer settings\n\n2. **Tasks Tab**:\n   - Add new tasks with `Enter task...` placeholder\n   - Set current task\n   - Delete tasks\n   - View completion statistics\n\n3. **Menu**:\n   - Toggle break reminders\n   - Configure notification sounds\n\n## Configuration\n\nModify timer durations in the Settings section:\n- Work time (default: 25 min)\n- Short break (default: 5 min) \n- Long break (default: 15 min)\n\nChoose notification sounds:\n- System beep\n- Bell sound\n- Full alert (visual+audio)\n\n## Troubleshooting\n\n**Sound not working?**\n```bash\nsudo dnf install alsa-utils pulseaudio-utils\n\n# Ubuntu/Mint\nsudo apt install pulseaudio-utils alsa-utils\n```\nNote: Note: Ubuntu/Mint typically include PulseAudio by default, but these ensure CLI tools are installed.\n\n**Missing fonts?**\n```bash\nsudo dnf install google-noto-sans-fonts\n\n#Ubuntu/Mint\nsudo apt install libnotify-bin\n```\n\n**Window not displaying properly?**\nTry running with basic theme:\n```python\nself.style.theme_use(\"default\")  # Change in code\n```\n\n## License\n\nMIT License - Free for personal and commercial use\n\n---\n\n*Adapt the Pomodoro durations and notification preferences to match your workflow!*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeter-l-svk%2Fpomodoro-timer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeter-l-svk%2Fpomodoro-timer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeter-l-svk%2Fpomodoro-timer/lists"}