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
Known Issues
- Skip doesn't work while on break (you can just make another session).
- Might not work if you have attention span of a goldfish.
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
Usage: flomo [OPTIONS] COMMAND [ARGS]...
A Flowmodoro CLI for productivity enthusiasts.
Options:
--help Show this message and exit.
Commands:
start (s) Start a Flowmodoro session.
Roadmap
- Add sound on timer/stopwatch start
- Notification (only Linux for now)
- 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.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 63e346e76c42e7a0f52f230976ebd98c7f3195c94315710306c6895ea3a02af4 |
|
MD5 | 7bb0e1e55cc480b3b9dba8a8c93fe88e |
|
BLAKE2b-256 | 6e252649f78021572a10c5e142796952daa0c3bf3d7bc3334d5664f03d5cbb57 |