https://github.com/xiaoxiae/florodoro
A pomodoro timer that grows procedurally generated trees and flowers while you're studying.
https://github.com/xiaoxiae/florodoro
education plants pomodoro pyqt5 python
Last synced: 6 months ago
JSON representation
A pomodoro timer that grows procedurally generated trees and flowers while you're studying.
- Host: GitHub
- URL: https://github.com/xiaoxiae/florodoro
- Owner: xiaoxiae
- License: gpl-3.0
- Created: 2021-01-20T16:01:32.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-07-22T10:45:29.000Z (almost 2 years ago)
- Last Synced: 2024-10-02T16:38:00.404Z (7 months ago)
- Topics: education, plants, pomodoro, pyqt5, python
- Language: Python
- Homepage:
- Size: 424 KB
- Stars: 33
- Watchers: 3
- Forks: 5
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
---
A pomodoro timer that grows procedurally generated trees and flowers while you're studying.
## Running Florodoro
First, install the app by running
```
pip install florodoro
```
To launch the application, simply run the `florodoro` command from a terminal of your choice.
If you'd like to use the latest (unstable) version, install from TestPyPI using
```
pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple florodoro
```
## Controls
### Top bar
- **Presets** – contains common pomodoro timings for study/break/cycle
- **Options**
- **Notify** – notification options (sound/pop-ups)
- **Plants** – plant settings (which ones to grow)
- **Overstudy** – enables breaks and studies longer than set
- **Statistics** – shows statistics + an interactive plant gallery
- **About** – a small TLDR about the project
### Bottom bar
- **Study for ...** – how long to study for
- **Break for ...** – how long to break after study
- **Cycles: ...** – how many times to repeat study-break (0 means infinite)
- **Icon: Book** – start the study session
- **Icon: Coffee** – start a break
- **Icon: Pause/continue** – pause/continue an ongoing study/break
- **Icon: Reset** – reset everything
## Local development
### Setup
1. create virtual environment: `python3 -m venv venv`
2. activate it `. venv/bin/activate` (assuming you use Bash)
3. install the package locally: `python3 -m pip install -e .`
- the `-e` flag ensures local changes are used when running the package
4. develop
5. run `florodoro` (make sure that `venv` is active)
_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._
### Publishing
All tagged commits in the `x.y.z` format are automatically published on PyPi using GitGub Actions.
If the commit is on the `testing` branch, the test PyPi instance is used.
The project follows [Semver](https://semver.org/) for version numbers and is currently under MAJOR version `0` (under rapid prototyping).
For as long as this is the case, the master branch will only contain MINOR versions, while the testing branch will contain PATCH versions.