A Flowmodoro CLI for producitivity enthusiasts.
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.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 309dd4b005b5d03f2002377c6a5001bdbe81134f24de18f00fcf9b7371817be7 |
|
MD5 | 95f883956b398c1858404be04ec22fc3 |
|
BLAKE2b-256 | 7f9be65417947d670db1d87a4ecf939bc60983319e6ada71e32aa065a1de3229 |