Recurring Task Reminder Overlay

WHAT IT DOES This script adds a floating, draggable overlay to your browser that displays a list of your recurring tasks with their next due dates, time since last completion, and current status (due, overdue, upcoming, or completed). Each task shows a quick-complete button that resets the timer to the next cycle and logs the completion timestamp. A history of recent completions is displayed for each task, and a badge shows the count of overdue and due tasks. Notifications alert you when tasks become overdue. Perfect for daily routines, weekly chores, monthly bills, and any recurring responsibility. WHERE IT RUNS The script works on any website—browsing, working, or researching. The overlay stays visible as you navigate between pages, providing a persistent task reminder. It works on any website regardless of framework. HOW TO USE After installation, the overlay appears automatically. Drag it to any corner of your screen. Click the ✅ button next to any task to mark it complete—the timer resets and the next due date updates. The badge shows due/overdue task count. Open the panel to configure: add tasks via JSON array with name, interval, unit (minute, hour, day, week, month, year), and active status; choose overlay position, opacity, theme (dark/light), reminder interval, and badge position. The panel also shows completed tasks when toggled, and supports per-site memory for position preferences. TECHNICAL MECHANISM The script uses a multi-stage task tracking pipeline. First, it loads tasks from GM_setValue as a JSON array. Second, it calculates each task's next due date by adding the interval (in the specified unit) to the last completion timestamp. Third, it determines status by comparing the due date to the current time—overdue (>24 hours past), due (24 hours), or completed (inactive). Fourth, it sorts tasks by due date or user preference. Fifth, it renders the overlay using dynamic HTML with status badges and completion buttons. Sixth, it handles completion by updating the lastCompleted timestamp, logging to history (with a configurable max), and re-rendering. Seventh, it runs a reminder check every interval to notify users of overdue tasks via GM_notification. The overlay updates in real time and stores all data locally. THE PANEL The settings panel is fully draggable and can be positioned anywhere on your screen. It automatically snaps to the nearest edge when released, keeping your workspace organized. The panel can be collapsed to a small bubble showing only a gear icon, and restored with a single click. Its position is remembered across page reloads using GM_setValue. The panel also responds to the Escape key, which instantly hides it until you click the bubble again. All settings are saved immediately when changed and persist across browser sessions. PLEASE NOTE This script requires the free BotGentz extension to run. Tasks are stored locally and not synced across devices. The script uses UTC offset for time calculations and does not account for daylight saving time changes automatically. The script does not access, store, or transmit any personal data or browsing history. All processing happens locally in your browser and never leaves your device.