MedSafe is a free, private, offline-first Windows desktop application designed to help households track medicine expiry dates locally. Version 1.1.0 introduces a reference-crafted glassmorphism visual experience, new brand identity, and enhanced inventory organization.
- Premium Glassmorphism Experience: Redesigned desktop interface featuring translucent frosted surfaces, floating rounded panels, inner border highlights, and tactile hover states.
- Atmospheric Visual Themes:
- Aurora Glass (Dark Mode): Deep obsidian backdrop with soft, out-of-focus cyan, blue, and purple ambient studio lighting.
- Pearl Glass (Light Mode): Frosted translucent white surfaces with gentle pastel lavender and sky blue ambient illumination.
- New Official Branding & Iconography: Custom-designed medicine capsule application icon and Windows executable/installer icon assets (
medsafe.icoandmedsafe.png). - Comprehensive Inventory Control: Real-time live search, multi-criteria sorting (Nearest Expiry, Farthest Expiry, Name A-Z, Name Z-A), and status/storage location filtering.
- Configurable Toast Reminders: Customized Windows notification alert thresholds with automatic same-day duplicate alert suppression.
- Zero-Cloud Local Privacy: 100% offline local SQLite storage with instant one-click CSV and JSON backup exports.
MEDSAFE helps organize medicine expiry information. It does not provide medical advice. Always verify the original packaging and consult a pharmacist or healthcare professional if you are unsure whether a medicine can be used.
MedSafe does not make medical safety judgments, determine therapeutic efficacy, or provide dosage recommendations.
- Download
MedSafe_Setup_v1.1.0.exe. - Double-click the installer to run the setup wizard.
- No Administrator Rights Required: MedSafe installs into your personal user profile:
%LOCALAPPDATA%\Programs\MedSafe\ - Optional choices during installation:
- Create a Desktop shortcut.
- Enable Daily Expiry Notifications: Automatically checks your medicine inventory every morning at 9:00 AM using Windows native toast alerts.
- Open your Start Menu and search for MEDSAFE.
- Double-click the MEDSAFE shortcut on your Desktop (if enabled).
- Or run directly from:
%LOCALAPPDATA%\Programs\MedSafe\MedSafe.exe.
All your medicine records, settings, and backups remain 100% private on your computer:
- Local Database:
%LOCALAPPDATA%\MedSafe\data\medsafe.db - Exports & Backups:
%LOCALAPPDATA%\MedSafe\backups\ - Application Logs:
%LOCALAPPDATA%\MedSafe\logs\medsafe.log
No accounts, no internet connection, and no cloud synchronization are ever used.
- Open Settings in the application.
- Click Export CSV to create a spreadsheet of your entire medicine inventory.
- Click Export JSON to create a full structured backup.
- Click 📂 Open Backups Folder to access your export files directly in Windows Explorer.
If scheduled notifications are enabled, MedSafe runs quietly in the background at 9:00 AM without opening any windows. When a medicine batch reaches an alert threshold (default: 30, 7, or 1 days before expiry, or when expired), a native Windows toast notification appears. Duplicate alerts are automatically suppressed on the same day.
- To uninstall, open Windows Settings → Apps → Installed apps, locate MEDSAFE, and click Uninstall (or use Start Menu → MEDSAFE → Uninstall MEDSAFE).
- Your Data Remains Safe: Uninstalling MedSafe removes the program binaries, shortcuts, and scheduled task. It does NOT delete your medicine database or backups in
%LOCALAPPDATA%\MedSafe\. If you reinstall MedSafe in the future, all your medicine records will be restored automatically.
MedSafe enforces a strict unidirectional layer separation:
frontend/: CustomTkinter desktop interface (zero SQL, zero directsqlite3access).backend/: Business services, data models, repositories, and platform utilities (zero CustomTkinter imports).backend/config.py: Dual-mode path resolution. Resolves local workspace paths during development and%LOCALAPPDATA%\MedSafewhen packaged.
- Operating System: Windows 10 or Windows 11.
- Python: Python 3.11 or newer (Python 3.13 recommended).
- Inno Setup: Version 6 (for compiling the Windows installer).
- Open PowerShell in the project directory:
py -m venv .venv .\.venv\Scripts\Activate.ps1 pip install -r requirements.txt
- Launch the desktop GUI:
python -m frontend.main - Run the headless notification checker:
python -m frontend.main --check-notifications
Run the complete pytest regression suite:
pytest -vCompile the standalone distribution with CustomTkinter assets and official icon:
pip install pyinstaller
pyinstaller medsafe.spec --noconfirm --cleanOutput directory: dist/MedSafe/ containing MedSafe.exe, assets/, and bundled libraries.
Compile the single-file setup wizard:
& "$env:LOCALAPPDATA\Programs\Inno Setup 6\ISCC.exe" setup.issOutput installer: dist/installer/MedSafe_Setup_v1.1.0.exe.
You can inspect the local SQLite database safely:
sqlite3 data/medsafe.db ".tables"
sqlite3 data/medsafe.db "SELECT * FROM settings;"sqlite3 "$env:LOCALAPPDATA\MedSafe\data\medsafe.db" ".tables"You can also open the .db file in DB Browser for SQLite or the SQLite Viewer IDE extension.