A simple CLI timer to calculate fasting zones.
Project description
⏲ ⏰ 🕰️ Fastimer
It is a little CLI timer to track fasts, designed specifically to help you monitor your fasting intervals.
😮 What's this for? There are a lot of apps like this one!
Well, I wrote this one out of annoyance when Zero once again refused to show me the statistics for a date. I was tapping on the calendar, but the app was doing nothing ¯\_(ツ)_/¯
Have no idea what was wrong with it. Anyway, the problem is not that hard, so I just wrote my own timer.
🙃 How to install it?
pip install fastimer
🙂 How to use it?
Simply run the script in the directory where you want to store data:
fastimer
The script shows you a menu with four commands available:
- Start New Fast
- End Active Fast
- Display Active Fast
- Display Fasting Statistics
Something is obvious: so, the first command starts a new fast, while the second command ends the active one.
The Display Active Fast
command shows you how active fast is going on. For instance:
ACTIVE FAST
Started: Mon, 20:19
Goal: Tue, 14:19 (18 hours)
Fasting zones:
- Anabolic: from Mon, 20:19
- Catabolic: from Tue, 00:19 <-- you are here
- Fat burning: from Tue, 12:19
- Ketosis: from Tue, 20:19
- Deep ketosis: from Thu, 20:19
Elapsed time: 13:38
Remaining: 04:21
| ##############################---------- | 75.8%
The Display Statistical Data
command shows you some statistics & achievement you were able to unlock (total fasting time, average fast length etc.).
For instance:
FASTING STATISTICS
Completed Fasts: 5
Total Fasting Time: 87h 27m
Average Fast Length: 17h 29m
Longest Fast Length: 18h 12m
Longest Fasting Streak: 3 days
Current Fasting Streak: 3 days
Achievements:
- Well Done! 5 fasts completed!
Please note that only completed fasts are taken into account in the statistics.
😌 Where I can see or edit my fasts?
The script stores all the fasts in fasts.yaml
file in the working directory. The file is quite human-readable, so you can just open it in your lovely text editor.
For instance, the completed fast in the journal looks like this:
- length: 16
started: 2022-07-20 19:59:14
stopped: 2022-07-21 12:00:33
The first parameter is the length of the fast, the second is the start date of this, and the third is the completion date.
For an active fast, the stopped
parameter is omitted.
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.