Metadata-Version: 2.4
Name: med-reminder
Version: 1.0.0
Summary: A Tkinter-based desktop medicine reminder with Email & Twilio call alerts
Author-email: Mourish Anthony <mourishantonyc@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/mourishantony/Med_remainder
Project-URL: Repository, https://github.com/mourishantony/Med_remainder
Project-URL: Bug Tracker, https://github.com/mourishantony/Med_remainder/issues
Keywords: medicine,reminder,health,tkinter,twilio,email
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pymongo>=4.6.0
Requires-Dist: twilio>=9.0.0
Requires-Dist: pygame>=2.5.0
Requires-Dist: pystray>=0.19.5
Requires-Dist: Pillow>=10.0.0
Dynamic: license-file

# 💊 Med Reminder

> A desktop medicine reminder app with **Email** and **Twilio phone call** alerts — built with Python & Tkinter.

## Features

- ⏰ Schedule one-time, daily, weekly, or custom repeating reminders
- 📧 Email notifications (Gmail App Password)
- 📞 Twilio phone call alerts
- 🔔 System tray notifications (Windows)
- 🔊 Alarm sound on reminder
- ⚙️ Built-in Settings UI — no `.env` editing needed
- 🗄️ MongoDB persistence

## Installation

```bash
pip install med-reminder
```

> **Requirements:** Python ≥ 3.9, MongoDB running locally on port 27017.

## Quick Start

```bash
# Launch the app
med-reminder
```

On first launch, click **⚙️ Settings** in the top-right to configure:

| Setting | Description |
|---------|-------------|
| Sender Email | Your Gmail address |
| Email App Password | [Generate here](https://myaccount.google.com/apppasswords) |
| Recipient Email | Who gets the alerts |
| Twilio Account SID | From [twilio.com/console](https://www.twilio.com/console) |
| Twilio Auth Token | From Twilio console |
| From Number | Your Twilio phone number |
| To Number | Your mobile number |

Settings are saved in `~/.med_reminder/settings.json` — no `.env` required.

## Optional: Add an alarm sound

Place an `alarm.mp3` in `~/.med_reminder/alarm.mp3`.

## Dependencies

| Package | Purpose |
|---------|---------|
| `pymongo` | Store reminders in MongoDB |
| `twilio` | Phone call alerts |
| `pygame` | Alarm sound |
| `pystray` | System tray icon (Windows) |
| `Pillow` | Tray icon image |
| `python-dotenv` | Optional `.env` fallback |

## License

MIT © Mourish Anthony
