Goodreads Reading Challenge Progress Badge

WHAT IT DOES

Goodreads Reading Challenge Progress Badge helps you stay on top of your yearly reading goal by displaying clear, visual progress tracking directly on Goodreads. The script extracts books read, pages read, challenge goal, and remaining books from the page, then displays a visible badge with progress percentage and count. Color-coded urgency indicators show whether you're on track (green), behind (yellow), significantly behind (orange), or unlikely to finish (red). A mini progress bar with pace indicators shows your current completion rate. The average pages per day needed to finish on time is calculated so you know exactly how much to read. A countdown to the challenge deadline keeps you motivated. Books read vs goal is shown with a detailed breakdown. Reading pace and projected completion date help you plan. Monthly reading stats show your progress throughout the year. A reading challenge summary report can be exported for sharing or tracking.

WHERE IT RUNS

This script runs on Goodreads, specifically on reading challenge pages, user profile pages, and the main reading challenge dashboard. It works on both desktop and mobile views, automatically detecting your reading progress data.

HOW TO USE

After installing through the BotGentz extension, navigate to your Goodreads reading challenge page or profile. The script automatically scans your reading progress and displays a badge with your current status. Open the configuration panel to view the full dashboard—books read, goal, percentage complete, remaining books, pace needed, days remaining, projected completion, and monthly breakdown. Use the configuration panel to customize your experience: toggle the progress badge on or off, show or hide the pace indicator, show or hide the countdown, show or hide monthly stats, set the auto-refresh interval in seconds, and override your target goal if needed. Use the "Scan Challenge" button to manually re-scan, or "Export Report" to copy a reading challenge summary to your clipboard.

PROGRESS EXTRACTION WITH PACE CALCULATION AND PROJECTION ENGINE

This script implements a reading challenge data extraction engine using DOM traversal and text pattern matching. The engine extracts books read, challenge goal, pages read, and monthly reading stats using multiple selectors and fallback patterns. The pace calculation engine determines the number of books per day needed to finish on time based on remaining books and days left in the year. The projection engine calculates the expected completion date based on current reading pace. The status classification uses progress percentage and pace comparison to determine urgency levels. The monthly stats breakdown aggregates reading counts by month when available.

THE PANEL

The configuration panel is fully draggable and remembers its position per-site using GM_setValue. It snaps to screen edges when dragged near them, collapses to a compact bubble when minimized, and supports Escape key for quick collapse. All settings—including badge visibility, pace display, countdown display, monthly stats, auto-refresh interval, and target goal override—are persisted across sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. The script runs on Goodreads and reads reading challenge data from the page. It does not capture, store, or transmit any personal information. All challenge data is stored locally in your browser using GM_setValue and never transmitted to external servers. The script reads only publicly visible reading challenge information displayed on the page. The pace calculation is based on the year-end deadline and may not account for specific challenge end dates. This tool is provided for organizational and informational purposes only.