A Python-based application that reminds users to stay hydrated by drinking water at regular intervals. The app uses desktop notifications, a user-friendly graphical interface, and motivational quotes to keep users on track with their hydration goals.
- Customizable Reminder Intervals: Set your preferred interval for hydration reminders.
- Progress Tracking: Track your daily water intake progress towards your hydration goal.
- Desktop Notifications: Get timely reminders through desktop notifications.
- Snooze Option: Snooze reminders for 1 minute if you're busy.
- Motivational Quotes: Display random motivational quotes to encourage hydration.
- Daily Reset: Automatically resets progress at midnight.
- Clock Display: Shows the current time on the main settings window.
- Python: Core programming language.
- ttkbootstrap: For creating the graphical user interface (GUI).
- Plyer: For desktop notifications.
- Playsound: For alarm sounds.
-
Clone the Repository:
git clone https://github.com/yourusername/water-reminder.git cd water-reminder -
Install Dependencies: Make sure you have Python 3.x installed. Then, install the required packages:
pip install ttkbootstrap playsound plyer
-
Add Alarm Sound: Place your alarm sound file (e.g.,
alarm_sound.mp3) in the same directory as the script. -
Run the Application:
python water_reminder.py
- Launch the app by running the script.
- Set your preferred reminder interval in minutes using the input field.
- Receive reminders with motivational quotes and desktop notifications.
- Track your daily water intake progress using the progress bar.
- Use the "Snooze" button to delay the reminder by 1 minute if needed.
water-reminder/
├── settings.json # Stores user settings (interval and progress)
├── alarm_sound.mp3 # Alarm sound file
└── water_reminder.py # Main Python script
Add screenshots of the application interface and notifications here.
- Fork the repository.
- Create a new branch for your feature (
git checkout -b feature-name). - Commit your changes (
git commit -m 'Add new feature'). - Push to the branch (
git push origin feature-name). - Create a pull request.
This project is licensed under the MIT License. See the LICENSE file for details.
For questions or suggestions, feel free to contact me at [your-email@example.com].