EnergyTracker was born out of a personal battle.
As a developer living with Fibromyalgia and other chronic illnesses, I realized that traditional "productivity" apps are often discouraging. They focus on how much you can do, rather than how much you can sustain. In the chronic illness community, we often refer to "Spoon Theory"—the idea that we have a limited amount of energy (spoons) each day.
I built this app to help myself—and others with similar special needs—visualize their daily "HP" (Health Points). It is a tool designed to help you practice Pacing, avoid "crash and burn" cycles, and communicate your energy patterns with health professionals.
EnergyTracker is a desktop companion that treats your energy like a rechargeable battery.
- Tasks (Chores, Work, Socializing) consume your HP.
- Exercises & Rest (Physical Therapy, Naps, Light Stretching) restore your HP.
- The Goal is to stay balanced and avoid hitting 0%.
This is the complete, high-fidelity README.md for your project. I have structured it to be accessible, supportive, and clear, specifically highlighting the "Game-like" HP logic and the accessibility settings for users with chronic conditions.
The app uses three core metrics to determine your daily capacity. While the main screen shows a simplified ring, you can click "More" to see the full breakdown:
| Color | Element | Game Analogy | Meaning |
|---|---|---|---|
| 🟡 Yellow | Stamina | Physical Energy | Your body's physical capacity (movement, chores). |
| 🔵 Blue | Mana | Mental Energy | Your mood, cognitive load, and "brain" levels. |
Your functional energy is calculated using this formula:
HP = Stamina + Mana
The Calendar is your command center for the month.
- Navigate: Click any date to view what you achieved or planned for that specific day.
- Highlights: Dates with recorded tasks or health events are highlighted so you can quickly see your "busy" days.
- Unified List: Below the calendar, you will see a combined list of both your appointments (Events) and your To-Dos (Tasks) for a clear view of your day's "cost."
- Track Progress: Use the Exercise Manager to log cardio exercise, stretching, or muscle building.
- Visual Feedback: Progress bars show how close you are to your daily goal.
Manage your daily chores and work with Priority Levels.
- Add Tasks: Group tasks by category (e.g., Work, Home, Medical).
- Prioritize: Assign "Low," "Medium," or "High" priority.
Click the "More" button to enter the deep-dive analysis.
- 31-Day Ring: View your entire month as a circular visualization.
- Color-Coded Health: Each day's segment is colored based on your total HP. 🔴 indicate "Crash Days," while 🟢show when you successfully stayed within your limits.
- Trend Analysis: Hover over segments to see exactly why a day was difficult (e.g., was it high Fatigue or low Mana?).
Chronic illness often comes with visual fatigue or "brain fog." You can customize the app to be easier on your eyes:
- UI Scaling: Go to Settings to increase the overall scale of the interface (e.g., 1.2x or 1.5x) to make buttons easier to hit.
- Text Size: Independently adjust the font size to ensure all instructions and labels are clear and readable without strain.
- 100% Offline: Your health data is yours alone. It is stored in a file named
energy_tracker.dbon your computer. Nothing is ever uploaded to the internet. - No Medical Advice: This app is a tracking tool, not a doctor. Always listen to your body over the app’s numbers.
- Download the
EnergyTracker.zipfrom the latest release. - Extract the folder and double-click EnergyTracker.exe.
- No installation process is required!
- Download the source code.
- Install the requirements:
pip install -r requirements.txt
- Run the application:
python main.py
I am developing this app as my energy allows. If you have suggestions on how to make the interface easier to use for people with brain fog, visual impairments, or chronic pain, please open an Issue or reach out.
Gentle reminder: You are more than your productivity.
Created with care for the chronic illness community.