Library Catalog Due Date Reminder Overlay

WHAT IT DOES

Library Catalog Due Date Reminder Overlay scans the current page for library catalog checked-out items, extracting book titles, due dates, renewal status, and fines from library accounts and catalog systems. The floating panel shows due dates with color-coded urgency indicators (green for safe, yellow for approaching, red for overdue), countdown timers to due date, and renewal eligibility. Alerts are provided for items due soon, renewal status is tracked, and items eligible for renewal are highlighted. Due date data can be exported as CSV or text for tracking, with one-click renewal links available where supported.

WHERE IT RUNS

Works on any library catalog website, including systems using ILS platforms like Sierra, Alma, Koha, Evergreen, and other library management systems. The script detects checked-out items using common selectors and can also fall back to general card-like elements. It works best on pages with structured loan lists containing due dates and renewal information.

HOW TO USE

The panel displays all checked-out items with their due dates, status indicators, and countdown timers. Click "Scan Items" to detect all checked-out items from the current page. Each item shows its due date with color-coded urgency (green for safe, yellow for approaching, orange for due today, red for overdue). Countdown timers show days remaining or days overdue. Items eligible for renewal are marked with a green "Eligible for renewal" tag. The panel automatically sends notifications for items due within the alert window (default 3 days). Export due date data as text for tracking.

MECHANISM — DUE DATE EXTRACTION WITH URGENCY CALCULATION

The script extracts checked-out items using a multi-strategy approach. It first attempts to find loan containers using common selectors (.checked-out-item, .loan-item, .checkout-item). From each container, it extracts book title, due date, renewal status, and fine information using targeted sub-selectors. Due dates are parsed from various date formats (MM/DD/YYYY, Month DD, YYYY). The urgency calculation uses the number of days until the due date: safe (7+ days), approaching (4-6 days), soon (1-3 days), today (0 days), overdue (negative). Alert windows are configurable, and notifications are triggered when items enter the alert window. Renewal eligibility is detected from status text and highlighted with a visual indicator.

THE PANEL

The floating panel is fully draggable and remembers its position per domain. Click the minimize button to collapse it to a small bubble, or press Escape to hide it. The panel automatically adjusts to different screen sizes and can be resized to show more content. All settings, including alert window preferences, are saved per domain. The panel integrates smoothly with any page layout using the BGPanel framework, maintaining clean separation from page content.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not send any data to external servers; all extracted due date data, history, and settings remain entirely local to your browser using GM_setValue. The script never reads password fields, hidden inputs, or file inputs. It stores only book titles, due dates, renewal status, and fine information from publicly visible page content. Item detection depends on the page structure; if items are not detected, use the "Scan Items" button to refresh extraction. Notifications require GM_notification permission. Data persists across browser sessions and is isolated per browser profile.