Kobo Web Reading Stats Overlay

WHAT IT DOES

Kobo Web Reading Stats Overlay reads reading stats and book progress from your Kobo account and displays a floating reading stats overlay showing your total books read, pages read, reading time, and current book progress. The badge shows the number of books read, pages read with a page icon, reading time in hours and minutes, and current book progress with title and percentage. The extension tracks reading history per month, storing each stats record with a timestamp. When you reach milestone book counts (5, 10, 25, 50, 100, 250, or 500 books), a desktop notification is triggered. The panel displays your current month's reading history and changes over time.

WHERE IT RUNS

This extension works on all Kobo pages at kobo.com and its subdomains, specifically on account pages where reading stats and book progress are displayed. It runs on the main account page, the reading stats page, the library page, and any page displaying reading information. The extension operates entirely within your browser and does not access Kobo's servers directly—it reads only what is visible on the page you are viewing. It works alongside the free BotGentz extension, which provides the necessary scripting environment.

HOW TO USE

Install the extension, then navigate to kobo.com and log in to your account. The extension automatically creates a floating reading stats overlay on the page. Click the extension's icon in your browser toolbar to open the settings panel. Use the "Show Overlay" / "Hide Overlay" button to toggle the badge visibility. The badge shows your books read, pages, reading time, and current book progress. Use the "Refresh" button to manually update the badge with the latest reading information. The "Show current book progress" toggle controls whether current book progress appears. The "Book milestone notifications" toggle controls desktop notifications for book count milestones. Adjust the overlay transparency using the opacity dropdown (70%, 82%, 92%, or 100%). Drag the badge by clicking and holding anywhere inside it. Resize it by dragging the bottom-right corner. Close the badge with the × button.

READING STATS EXTRACTION WITH MULTI-SELECTOR FALLBACK AND MILESTONE NOTIFICATION

Unlike simple stats display tools, this extension uses a multi-selector extraction engine to find reading stats from Kobo's varying page structures. It searches for books read using multiple selector patterns (.books-read, .books-count, .total-books) and falls back to text parsing. Pages read are extracted from page selectors, supporting comma-separated numbers. Reading time is extracted from time selectors, supporting both minutes and hours formats. Current book and progress are extracted from current book selectors, capturing title and percentage. Monthly reading history is stored as a key-value object where keys are year-month strings and values are arrays of stats records with timestamps, limited to 20 entries per month. Book milestone notifications trigger at specific book counts (5, 10, 25, 50, 100, 250, 500), with a once-per-day cooldown per milestone.

THE PANEL

The panel supports drag-to-move anywhere on the page. It remembers its position per site, so it stays where you placed it on kobo.com. Click the panel header to collapse it down to just the minimized bubble, or click the expand handle to show the full panel. The panel can be resized by dragging the bottom-right corner. Press the Escape key to close the expanded panel and return to the minimized state. All panel settings, including position, size, collapsed state, opacity, progress visibility, notification preference, and monthly reading history, are saved per site and persist across browsing sessions.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and active, as it provides the underlying DOM injection and script execution environment. Kobo's website changes periodically, and reading element structures, class names, and page layouts may be updated. When that happens, the extension may stop detecting stats data until an update is released. The extension stores your overlay position, size, opacity, visibility, progress preference, notification preference, and monthly reading history locally in your browser's storage using GM_setValue. Reading history is stored as a key-value object where keys are year-month strings and values are arrays of stats records. The reading stats displayed are read from the page—the extension does not access Kobo's internal reading data. Always verify with Kobo directly for the most accurate reading information. No data is ever sent to any server, and no personal information is collected. You can clear all stored settings at any time by clearing your browser data for kobo.com.