flomo
is a crossplatform TUI/CLI for using the Flowtime Technique, also known as the Flowmodoro Technique. Itโs a task execution helper, or in other words, a productivity booster! ๐
flomo
allows you to work on tasks in a flow state, manage your work/break time, and track your sessions.
Built with: rich & blessed (TUI), click (CLI), notify-send for Linux notifications, playsound (Windows & Mac sound), paplay (Linux sound), sqlite3 (database).
โจ Features
- Cross-Platform ๐
- Stopwatch for Flow and Timer for Breaks โฑ๏ธ
- Session tracker (date, duration, tag, and session) ๐๏ธ
- Session manager: easily manipulate the sessions via CLI โ๏ธ
- Customizable, Clean UI ๐จ
- Notifications (Linux only, for now) ๐
- Fairly easy-to-use, I suppose ๐ค
- (Potential) productivity booster ๐ฅ
๐ Background
flomo
started as a Hackathon (livestream) on June 6, 2024, with @Jonak-Adipta-Kalita and @AnubhavSC. We aimed to create a small project that was fun and could potentially help others. Weโre all productivity fanatics, and this project is heavily inspired by pomo.
However, two hours in, we realized it was harder than expected. We spent a lot of time debugging and refactoring. Here are our learnings from the Hackathon.
๐ Flow and Flowtime Technique
Mihaly Csikszentmihalyi was known for his work on Flow Theory. He describes โflowโ as:
โA state of being in which people become so immersed in the joy of their work or activity โthat nothing else seems to matter.โโ
As developers, creators, and romantics, we often experience that state of โflow.โ This โflowโ can vary, sometimes increasing or decreasing.
This can be visualized with a graph:
We can take advantage of this by identifying the right time to take a breakโwhen the โflowโ is depleting. This is the Flowtime technique.
It works like this: If you work for x minutes, take a break for x/5 minutes. Then, repeat. โณ
This requires a good deal of discipline, meaning you need at least some natural focus. If not, check out the Pomodoro Technique! ๐
๐ ๏ธ Installation
๐ Pre-requisites
- ๐ Python โฅ 3.12
- ๐ฆ pip
- ๐ ๏ธ GCC Compiler if installing from source.
๐ฆ Instructions
Using PyPi package
pip install flomodoro
Note: If youโre on Linux, ensure /home/user/.local/bin
is in your PATH
. More info for Linux newbies
Installing from source
git clone https://github.com/moiSentineL/flomo.git
cd flomo
pip install -r requirements.txt
gcc -fPIC -shared -o flomo/session_id.so flomo/session_id.c
pip install -e .
๐ Getting Started
Initialize flomo by:
flomo init
Start a flow by:
flomo s
Start a flow with the tag work
and the session name math
:
flomo s -t work -n math
Check the wiki for more info ๐
๐ค๏ธ Roadmap
- โ Add sound on timer/stopwatch start
- โ Notification (only Linux for now)
- โ Configure colors
- โ Track sessions
- โ Configure colors
- โ Skipping Break
- ๐ง Chart Generation / Statistics
Check our Kanban Board.
๐ค How to Contribute
Want to help? Great! Hereโs how:
- Fork this repo.
- Clone it to your local machine.
- Create a branch for your changes.
- Make your edits and test them.
- Commit and push your changes.
- Open a pull request to the
main
branch.
Note: if youโre new to Git and Github, I suggest you read this Intro to Git and GitHub for Beginners.
Letโs collaborate! ๐