{"id":23820111,"url":"https://github.com/claudiaslibrary/animedoro","last_synced_at":"2026-05-08T15:30:16.958Z","repository":{"id":263415380,"uuid":"890329413","full_name":"ClaudiasLibrary/animedoro","owner":"ClaudiasLibrary","description":"Pomodoro timer but for anime fans. Or simply for those who preferer 40 minutes work and 20 minutes break.","archived":false,"fork":false,"pushed_at":"2024-12-07T13:17:22.000Z","size":7,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-02T07:19:46.371Z","etag":null,"topics":["100daysofcode","anime","kawaii","pixel-art","pomodoro-timer","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ClaudiasLibrary.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-11-18T11:41:19.000Z","updated_at":"2024-12-30T22:03:14.000Z","dependencies_parsed_at":"2024-11-18T12:55:59.211Z","dependency_job_id":"abaec877-2f3b-4323-8d0a-2fb0e7fcc4a7","html_url":"https://github.com/ClaudiasLibrary/animedoro","commit_stats":null,"previous_names":["claudiaslibrary/animedoro"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClaudiasLibrary%2Fanimedoro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClaudiasLibrary%2Fanimedoro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClaudiasLibrary%2Fanimedoro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClaudiasLibrary%2Fanimedoro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ClaudiasLibrary","download_url":"https://codeload.github.com/ClaudiasLibrary/animedoro/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240100515,"owners_count":19747683,"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":["100daysofcode","anime","kawaii","pixel-art","pomodoro-timer","python"],"created_at":"2025-01-02T07:19:48.906Z","updated_at":"2026-05-08T15:30:16.903Z","avatar_url":"https://github.com/ClaudiasLibrary.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Logo](heart.png)\n# Animedoro\nPomodoro timer but for anime fans.  \nOr simply for those who preferer 40 minutes work and 20 minutes break.  \n\nMade for Angela Yu's 100 days of code challenge\n\nAnimedoro is a Pomodoro-style productivity timer application built with Python's `tkinter` library.\nIt helps you manage work sessions and breaks with a customizable timer. This app includes features like:\n\n- Work sessions (default: 40 minutes)\n- Short breaks (default: 20 minutes)\n- Long breaks (default: 20 minutes)\n- Bonus \"Episode\" mode after 8 work sessions\n- Visual check marks to track completed work sessions\n\n## Features\n\n- **Work Timer**: Work for a set duration (default: 40 minutes).\n- **Break Timer**: Short breaks after every work session and long breaks after every 4 work sessions.\n- **Visual Feedback**: Track completed work sessions with 🍡 check marks.\n- **Customizable Timings**: Easily adjust the work and break durations by modifying constants in the code.\n- **Reset Function**: Reset the timer and clear the check marks.\n\n## Requirements\n\n- Python 3.x\n- `tkinter` (which comes pre-installed with Python)\n- A heart image (`heart.png`) for the background.\n\n## Setup\n\n1. Download or clone the repository to your local machine.\n2. Place the `heart.png` image file in the same directory as the script.\n3. Run the script:\n\n   ```bash\n   python animedoro_timer.py\n   ```\n\n## How it Works\n\n- **Start**: Click the \"Start\" button to begin a work session. The timer will countdown from the set work duration.\n- **Breaks**: After each work session, the app will automatically switch to a short break or long break, depending on the session count.\n- **Reset**: Click the \"Reset\" button to stop the timer and reset the session counter.\n\n## Code Walkthrough\n\n### Constants\nThe following constants define the durations for work sessions and breaks:\n- `WORK_MIN`: Duration of a work session in minutes (default: 40 minutes).\n- `SHORT_BREAK_MIN`: Duration of a short break in minutes (default: 20 minutes).\n- `LONG_BREAK_MIN`: Duration of a long break in minutes (default: 20 minutes).\n- `REPS`: Keeps track of the number of completed work and break sessions.\n\n### Functions\n\n#### `reset_timer()`\nThis function stops the timer, resets the countdown to \"00:00\", and clears the check marks for completed sessions.\n\n#### `start_timer()`\nStarts the countdown based on the current session type:\n- Work session: 40 minutes\n- Short break: 20 minutes\n- Long break: 20 minutes\n\n#### `count_down(count)`\nHandles the countdown process by updating the UI every second. Once the countdown reaches 0, the next session starts, and check marks are updated based on completed work sessions.\n\n### UI Setup\n\nThe user interface is built using `tkinter`, with:\n- A title label displaying the current session (Work, Episode, or Bonus).\n- A canvas displaying the timer countdown.\n- Buttons for starting and resetting the timer.\n- A label to show completed work sessions using 🍡 symbols.\n\n## Customization\n\nYou can customize the work, short break, and long break durations by modifying the following constants in the script:\n\n```python\nWORK_MIN = 40\nSHORT_BREAK_MIN = 20\nLONG_BREAK_MIN = 20\n```\n\nAdditionally, feel free to replace the `heart.png` image with your own background image.\n\n## License\n\nThis project is open source and available under the MIT License.\n\n## Acknowledgements\n\n- `tkinter` for the GUI library.\n- Inspiration from the Pomodoro Technique for productivity.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclaudiaslibrary%2Fanimedoro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclaudiaslibrary%2Fanimedoro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclaudiaslibrary%2Fanimedoro/lists"}