Medication Schedule Reminder Overlay for Caregivers

WHAT IT DOES

This userscript helps caregivers manage medication schedules by extracting prescription details and building a visual reminder system. It scans medication information pages, doctor's notes, or prescription documents for drug name, dosage, frequency, time of day, and special instructions. It parses common timing patterns like "twice daily", "every 8 hours", "with meals", and "before bedtime", then calculates the next dose time and displays a real-time countdown. The script generates a daily schedule chart, highlights missed doses, and exports the medication schedule as a printable HTML chart or CSV file. It also provides visual alerts when a dose is due and tracks administration history.

WHERE IT RUNS

The script works on medication information pages, prescription documents, doctor's notes, and any page with medication details. It runs entirely within your browser, reading only the visible content of the current page. It does not track your browsing history, access other tabs, or send any data externally. All medication data is processed locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. The script auto-scans pages for medication information on load (toggle this on/off). Click "Scan page for medications" to manually scan the page. The panel displays each medication with its name, dosage, frequency, special instructions, and a countdown to the next dose. The schedule preview shows all planned dose times. Use the export dropdown to choose your format—HTML (printable schedule) or CSV. Click "Export Schedule" to download the medication schedule. The HTML export creates a printable chart with all medications and their dose times.

THE TECHNICAL MECHANISM

This script uses DOM traversal and pattern matching to extract medication data from page text. It scans for medication elements using selectors like .medication, .prescription, .drug, and [class*="medication"]. For each element, it extracts the drug name, dosage (using patterns like "X mg"), and frequency. The frequency parser handles common patterns: "every X hours" (calculates interval-based scheduling), "X times a day" (distributes doses evenly over 24 hours), "twice daily", "three times daily", "once daily", "with meals", "before bed", and "as needed". The schedule generator creates dose times based on the frequency pattern. The next dose calculation finds the next scheduled dose after the current time and shows a countdown in minutes. The display updates every 60 seconds to keep the countdown current.

THE PANEL

The panel is draggable anywhere on the screen and remembers its position between sessions. It can be collapsed to a small floating bubble to minimize distraction, and expanded again with a single click. The panel's width can be adjusted, and pressing the Escape key closes it instantly. All settings—export format and auto-scan—are persisted locally using GM_setValue, so your preferences remain intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script is designed to assist caregivers with medication management—always verify the extracted information against the original prescription. The schedule generation is based on the frequency patterns detected and may not capture every possible dosing schedule. The countdown timer is a visual aid and should not be relied upon as the sole reminder system. Always consult with a healthcare professional for medication management. The script does not access external APIs or store any data outside your browser. No data from your browsing is stored or transmitted anywhere—all processing occurs entirely in your browser.