{"id":19635973,"url":"https://github.com/xiaoxiae/florodoro","last_synced_at":"2025-04-28T08:31:45.377Z","repository":{"id":39592394,"uuid":"331357847","full_name":"xiaoxiae/Florodoro","owner":"xiaoxiae","description":"A pomodoro timer that grows procedurally generated trees and flowers while you're studying.","archived":false,"fork":false,"pushed_at":"2023-07-22T10:45:29.000Z","size":434,"stargazers_count":33,"open_issues_count":11,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-02T16:38:00.404Z","etag":null,"topics":["education","plants","pomodoro","pyqt5","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xiaoxiae.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2021-01-20T16:01:32.000Z","updated_at":"2024-09-23T16:46:59.000Z","dependencies_parsed_at":"2023-02-09T11:16:34.462Z","dependency_job_id":"20cd5a0d-bf56-4dc2-94e0-951a24ca98ad","html_url":"https://github.com/xiaoxiae/Florodoro","commit_stats":{"total_commits":103,"total_committers":3,"mean_commits":"34.333333333333336","dds":"0.21359223300970875","last_synced_commit":"23824c87b3b8f3f7404db2689d094d08de0f34d7"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiaoxiae%2FFlorodoro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiaoxiae%2FFlorodoro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiaoxiae%2FFlorodoro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiaoxiae%2FFlorodoro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xiaoxiae","download_url":"https://codeload.github.com/xiaoxiae/Florodoro/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224102445,"owners_count":17256172,"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":["education","plants","pomodoro","pyqt5","python"],"created_at":"2024-11-11T12:27:50.741Z","updated_at":"2024-11-11T12:27:51.272Z","avatar_url":"https://github.com/xiaoxiae.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](https://raw.githubusercontent.com/xiaoxiae/Florodoro/master/florodoro/images/logo.svg)\n\n---\n\nA pomodoro timer that grows procedurally generated trees and flowers while you're studying.\n\n![](https://raw.githubusercontent.com/xiaoxiae/Florodoro/master/florodoro/images/preview.svg)\n\n## Running Florodoro\nFirst, install the app by running\n```\npip install florodoro\n```\n\nTo launch the application, simply run the `florodoro` command from a terminal of your choice.\n\nIf you'd like to use the latest (unstable) version, install from TestPyPI using\n```\npip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple florodoro\n```\n\n## Controls\n\n### Top bar\n- **Presets** – contains common pomodoro timings for study/break/cycle\n- **Options**\n\t- **Notify** – notification options (sound/pop-ups)\n\t- **Plants** – plant settings (which ones to grow)\n\t- **Overstudy** – enables breaks and studies longer than set\n- **Statistics** – shows statistics + an interactive plant gallery\n- **About** – a small TLDR about the project\n\n### Bottom bar\n- **Study for ...** – how long to study for\n- **Break for ...** – how long to break after study\n- **Cycles: ...** – how many times to repeat study-break (0 means infinite)\n- **Icon: Book** – start the study session\n- **Icon: Coffee** – start a break\n- **Icon: Pause/continue** – pause/continue an ongoing study/break\n- **Icon: Reset** – reset everything\n\n## Local development\n\n### Setup\n1. create virtual environment: `python3 -m venv venv`\n2. activate it `. venv/bin/activate` (assuming you use Bash)\n3. install the package locally: `python3 -m pip install -e .`\n\t- the `-e` flag ensures local changes are used when running the package\n4. develop\n5. run `florodoro` (make sure that `venv` is active)\n\n_Note: this might not work when the path to the cloned reposity contains whitespace. I didn't look into the reason why (likely a bug in `venv`), just something to try if something fails._\n\n### Publishing\nAll tagged commits in the `x.y.z` format are automatically published on PyPi using GitGub Actions.\nIf the commit is on the `testing` branch, the test PyPi instance is used.\n\nThe project follows [Semver](https://semver.org/) for version numbers and is currently under MAJOR version `0` (under rapid prototyping).\nFor as long as this is the case, the master branch will only contain MINOR versions, while the testing branch will contain PATCH versions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiaoxiae%2Fflorodoro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxiaoxiae%2Fflorodoro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiaoxiae%2Fflorodoro/lists"}