fastimer 1.1.0

A simple CLI timer to calculate fasting zones.

⏲ ⏰ 🕰️ 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:

1. Start New Fast
2. End Active Fast
3. Display Active Fast
4. 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:         4
Total Fasting Time:      69h 15m
Average Fast Length:     17h 18m
Longest Fast Length:     18h 4m
Longest Fasting Streak:  2 days
Current Fasting Streak:  2 days

Achievements:
- Nothing yet.

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.