Universal Reading Time by Section Badge

WHAT IT DOES This script scans the current page content and calculates reading time for the entire page and for each major section—identified by headings (h1-h6), section elements, or content blocks. It displays a floating badge panel showing total reading time, average reading time per section, and a breakdown of reading time by section with color-coded indicators: green for short (10 minutes). Inline badges are added next to each heading showing the estimated reading time for that section. Users can adjust the reading speed (words per minute), click on any section in the panel to scroll to it, copy the full reading time report, and export data as CSV. Reading time snapshots are stored per domain locally for tracking over time. WHERE IT RUNS Works on any webpage with textual content—blog posts, articles, documentation, news sites, or any page with headings and paragraphs. The script scans the DOM for headings and content blocks, making it compatible with most content-focused websites. HOW TO USE The panel appears automatically when you visit a content page. It shows the total reading time at the top with a color-coded indicator, followed by a breakdown of each section with its heading, word count, and reading time. Inline badges appear next to each heading on the page, showing the reading time and word count. Adjust the reading speed using the "Words per minute" input—the times update instantly. Click any section in the panel to scroll smoothly to that section on the page. Click "Copy Report" to copy a full text report with all sections and times. Export all data as CSV with section headings, word counts, and reading times. The "Clear History" button removes stored snapshots for the current domain. The panel automatically saves a snapshot each time you visit, building a history of content length and reading times. TECHNICAL MECHANISM: DOM TRAVERSAL WITH HEADING-BASED SECTION SEGMENTATION The script uses DOM traversal to find all heading elements (h1-h6). It captures the position (vertical offset) of each heading, then extracts the content between each heading and the next heading by iterating through sibling elements until the next heading is reached. Content elements inside script, style, nav, header, and footer tags are excluded to avoid counting non-content text. The extracted text is cleaned and word count is calculated by splitting on whitespace. Reading time is calculated as word count divided by the user's words-per-minute setting (default 200). The total reading time is the sum of all section times. Each section is stored with its heading text, heading level, word count, reading time, and a reference to the heading element for scroll navigation. Inline badges are created as span elements with a border and background, inserted after the heading text. The color coding uses thresholds: 10 min (red). Click events are attached to section cards in the panel to enable smooth scrolling. Each snapshot stores the full section list with word counts and reading times, capped at 30 entries per domain. THE PANEL The reading time badge appears in a draggable, resizable panel that remembers its position per site. The panel shows the total reading time, section breakdown with click-to-scroll functionality, and history. Inline badges appear next to headings on the page. Drag by the header to reposition, collapse to a compact icon with a click, and resize using the bottom-right corner. The panel snaps to screen edges for tidy placement and closes with the Escape key. All settings—words-per-minute and panel position—persist per website using GM_setValue, so your view returns exactly as you left it. PLEASE NOTE This script requires the free BotGentz extension to run. The reading time calculation is an estimate based on average reading speed—actual reading time may vary. The section detection relies on headings; pages without structured headings may show a single "Page Content" section. Inline badges are added to the page's DOM; they can be removed by refreshing the page or disabling the script. The script excludes navigation, header, footer, and script content to focus on the main content. All data is stored locally in your browser via GM_setValue and never transmitted.