A Flowmodoro CLI for producitivity enthusiasts.
Reason this release was yanked:
not working
Project description
flomo
flomo
is a TUI/CLI for using the Flowtime Technique a.k.a. Flowmodoro Technique. It is a task execution helper, or in other words, productivity booster. flomo
allows you to work on tasks in a flow state, track and manage your work/break time.
Background
flomo
was started as a Hackathon (livestream) on 6 June, 2024 with @Jonak-Adipta-Kalita and @AnubhavSC. We wanted to create a small scale project which was fun to make and possibly helped others as well. Moreover, we all are productivity fanatics. This is a project heavily inspired by pomo.
And when we were 2 hours in, we realised that it was harder than we thought. We spent a lot of time debugging and refactoring. And we're still working on it.
Flow and Flowtime Technique
Mihaly Csikszentmihalyi was known for his work on Flow Theory. He describes "flow" as[^1]:
"A state of being in which people become so immersed in the joy of their work or activity 'that nothing else seems to matter.'"
And as developers/creators/romantics, we experience that state of "flow" often. This "flow" can vary at times, meaning that it can increase or decrease.
This can easily be shown with a graph:
However, we can exploit that to our advantage and work efficiently, by finding the right time to take a break. And that right time is when the "flow" is depleting. And this is called the Flowtime technique.
It works fairly simply: If you work for x amount of minutes, you should take a break for x/5 amount of minutes. And repeat.
This calls for extensive amount of discipline. Which means that you must have at least some amount of natural focus. If not, I encourage you to check the Pomodoro Technique out.
Installation
pip install flomodoro
Source
git clone https://github.com/moiSentineL/flomo.git
cd flomo
pip install -r requirements.txt
pip install -e .
Usage
Getting Started
Start a flow with tag "work" and "write some code" as session name:
flomo start -t work -n "write some code"
Commands
flomo --help
start, s starts a flow session
Roadmap
- Add sound on timer/stopwatch start
- Tracking data / time studied
- Configure colors
Check our Kanban Board
[^1]: : Csikszentmihalyi, M. (1990). Flow: The Psychology of Optimal Experience. New York: Harper and Row. p. 15 ISBN 0-06-092043-2
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for flomodoro-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 45d0c553d5a7b62715afafc4197272109a234d8880c88da0fa9a894941cf497d |
|
MD5 | c9a9a8a02ddfc9f96bc3f1b7a5fcbdac |
|
BLAKE2b-256 | 1d4d28fda9d8acf78897c04a9fdbd43c67e2017ec3825be06a43b38bb5f86894 |