Skip to content

Ryuji-Kishima-Fella/mood_tracker

Repository files navigation

Python GitHub last commit License

Mood Tracker Screenshot

Mood Tracker (Python)

Version Status GitHub release (latest by date)

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.


🌟 Features

  • 📝 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

About the Project

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.


How to Run

  1. Install Python 3.10+
  2. Download or clone this repository:
git clone https://github.com/Ryuji-Kishima-Fella/mood-tracker.git
  1. Open the terminal and navigate to the mood_tracker folder:
cd mood_tracker
  1. Run the program:
pythoon mood_tracker.py

Menu Options

=== Mood Tracker ===
1. Log today's mood
2. View mood history
3. View mood summary
4. Export mood history to CSV
5. Exit

Example Output

Mood Summary Example:

📊 Mood Summary:
  Happy: 5 times
  Stressed: 2 times
  Tired: 1 time

Most frequent mood: 😌 Happy

CSV Export Example:

Date,Mood
2025-11-05 19:28:56, Happy
2025-11-05 22:56:59, Tired

Future Improvements

  • Add charts/graphs
  • Add daily reminders
  • Turn into a web or mobile app

🕓 Version History

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

🧩 Changelog

v2.0 — November 8, 2025

  • First GUI version using CustomTkinter
  • Basic mood logging, CSV export, and summary chart

v2.1 — November 9, 2025

  • Added edit/delete moods directly from GUI
  • Introduced dark mode support and refreshable pie chart
  • Fixed file I/O and auto-refresh issues

v2.2 — November 9, 2025

  • 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

🚀 Release Checklist

  1. Update version number in README and CHANGELOG
  2. Commit and push changes
  3. Run git release vX.Y.Z (or create tag manually)
  4. Verify tag appears under Releases

About

A simple Python app to record and track my daily moods.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages