A simple Python program that helps you record, view, and analyze your daily moods - created as part of my journey learning Python and GitHub version control.
- 📝 Log your mood for the day
- 📖 View your mood history (stored in a local text file)
- 📊 See a mood summary showing how often each mood occurs
- 📤 Export mood history to CSV for data analysis (NEW!)
- 💾 All data saved locally for privacy and simplicity
The Mood Tracker started as a console-based learning project to practice:
- File I/O in Python
- Data storage and retrieval
- Simple analytics (frequency counts)
- Version control and GitHub documentation
It demonstrates progressive skill growth — from basic input/output to structured data handling and CSV exporting.
- Install Python 3.10+
- Download or clone this repository:
git clone https://github.com/Ryuji-Kishima-Fella/mood-tracker.git- Open the terminal and navigate to the mood_tracker folder:
cd mood_tracker- Run the program:
pythoon mood_tracker.py=== Mood Tracker ===
1. Log today's mood
2. View mood history
3. View mood summary
4. Export mood history to CSV
5. ExitMood Summary Example:
📊 Mood Summary:
Happy: 5 times
Stressed: 2 times
Tired: 1 time
Most frequent mood: 😌 HappyCSV Export Example:
Date,Mood
2025-11-05 19:28:56, Happy
2025-11-05 22:56:59, Tired
- Add charts/graphs
- Add daily reminders
- Turn into a web or mobile app
| Version | Date | Changes |
|---|---|---|
| v1.0.0 | 2025-11-04 | Initial release with basic logging and view history |
| v1.1.0 | 2025-11-05 | Added mood summary and CSV export features |
| v1.2.0 | 2025-11-06 | Added view-by-date and delete-last-entry features |
| v1.3.0 | 2025-11-07 | Added edit entry feature and improved menu structure |
| v2.0.0 | 2025-11-08 | First GUI version using Tkinter |
| v2.1.0 | 2025-11-09 | Switched to CustomTkinter for dynamic GUI |
| v2.2.0 | 2025-11-09 | Added real-time chart visualization |
- First GUI version using CustomTkinter
- Basic mood logging, CSV export, and summary chart
- Added edit/delete moods directly from GUI
- Introduced dark mode support and refreshable pie chart
- Fixed file I/O and auto-refresh issues
- Added date filters (All, Today, Last 7 Days, Last 30 Days)
- Improved window focus behavior for History and Summary
- Enhanced UX with live refresh and theme consistency
- Update version number in README and CHANGELOG
- Commit and push changes
- Run
git release vX.Y.Z(or create tag manually) - Verify tag appears under Releases