E-Book Library Wait List Estimate Badge

WHAT IT DOES

E-Book Library Wait List Estimate Badge scans the current page for e-book library listings, extracting book titles, wait list positions, estimated wait times, availability status, and formats (Kindle, ePub, PDF, etc.) from library catalog systems (Libby, OverDrive, CloudLibrary, etc.). The floating panel shows wait list position with color-coded indicators, estimated wait time based on loan periods and checkout history, and format availability. A summary shows total wait list items, positions, and estimated days. Add personal notes to items and export wait list data as CSV or text. Books with short wait times are highlighted, and availability alerts are provided when positions move forward.

WHERE IT RUNS

Works on any e-book library catalog, including Libby, OverDrive, CloudLibrary, Hoopla, and other library digital lending platforms. The script detects wait list items using common selectors and can also fall back to general card-like elements. It works best on pages with structured wait list or hold information.

HOW TO USE

The panel displays all wait list items with their positions, status, and formats. Click "Scan Wait List" to detect all items from the current page. Each item shows its position color-coded (green for near front, yellow for mid-queue, red for far back). Estimated wait time is calculated based on loan period settings. Formats (Kindle, ePub, PDF) are detected and displayed. Add notes to any item for personal tracking. Export wait list data as text for reference. The panel highlights items near the front of the queue (position 5 or less) and provides one-click alerts for those items.

MECHANISM — WAIT LIST EXTRACTION WITH WAIT TIME ESTIMATION

The script extracts wait list items using a multi-strategy approach. It first attempts to find hold containers using common selectors (.waitlist-item, .hold-item, .ebook-item). From each container, it extracts book title, position, availability status, and formats using targeted sub-selectors. Position is parsed from position text, and status is detected from status text (available, waiting, not owned). Formats are detected by matching format keywords (Kindle, ePub, PDF, Audio, Read Online) in the item text. Wait time estimation uses the formula: estimatedDays = position × loanPeriodDays / totalCopies. The loan period is configurable in settings (default 21 days). Color coding follows urgency-based indicators: green for position 1, yellow for 2-5, orange for 6-10, red for 10+.

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 loan period and alert thresholds, 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 wait list data, notes, 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, positions, status, formats, and user-entered notes from publicly visible page content. Item detection depends on the page structure; if items are not detected, use the "Scan Wait List" button to refresh extraction. Wait time estimates are based on configured loan periods and may vary from actual library policies. Data persists across browser sessions and is isolated per browser profile.