PyTray Reminder 🔔

A customizable desktop reminder application built in Python. It runs in the system tray, sends timed notifications, and allows easy start/stop controls via menu or console. Ideal for habit-building, breaks, or quick productivity nudges!

✨ Features

• Customizable Reminders: Set your own interval (in minutes) and message.
• System Tray Integration: Right-click menu to start/stop reminders or quit.
• Desktop Notifications: Cross-platform alerts using Plyer (works on Windows, macOS, Linux).
• Console Controls: Type 'exit' in the terminal to safely quit.
• Colorful CLI: User-friendly input prompts with colorama for better UX.
• Lightweight & Daemon-Friendly: Runs in background threads without blocking.

📋 Requirements

• Python 3.8+
• Libraries: pystray, Pillow (PIL), plyer, colorama

Install dependencies:

pip install pystray Pillow plyer colorama

🚀 Quick Start

1. Clone the repo:

cd pytray-reminder

2. Run the app:

python main.py

3. Follow the prompts:

• Enter reminder interval (e.g., 5 minutes).
• Enter your custom message (e.g., "Time to stretch!").
• The app starts automatically and shows a tray icon.

4. Controls:

• Tray Menu: Right-click the icon → Start/Stop Reminders or Quit.
• Console: Type exit to stop and close.

Note: On first run, a warning box appears – press Enter to proceed. The app creates no files by default (shortcuts are optional/unimplemented).

• Tray Icon: A blue circle in your system tray.
• Notification Example: "⏰ Reminder: Time to do something!" pops up every X minutes.
• Console Input: Colorful prompts for setup.

🛠 Customization

Edit main.py:

• Change default reminder_interval (in seconds).
• Modify reminder_message.
• Extend the tray menu in main() for more options (e.g., change icon).

To add desktop shortcuts or autostart (uncomment in code):

• Use pywin32 on Windows or subprocess for cross-platform setup.

🤝 Contributing

1. Fork the repo.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit changes (git commit -m 'Add amazing feature').
4. Push to branch (git push origin feature/amazing-feature).
5. Open a Pull Request!

Issues? Open one with details. Feedback welcome!

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with love by MS Coder ✨
• Inspired by simple productivity tools.
• Thanks to libraries: pystray, Pillow, Plyer, Colorama.

Star this repo if it helps your workflow! 🌟