med-reminder 1.0.0

A Tkinter-based desktop medicine reminder with Email & Twilio call alerts

💊 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

pip install med-reminder

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

Quick Start

# 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
Recipient Email	Who gets the alerts
Twilio Account SID	From 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