Long-Form Article Chapter Navigator

WHAT IT DOES

Long-Form Article Chapter Navigator transforms how you navigate lengthy articles by creating a floating chapter navigation sidebar. The script automatically detects all headings (h1 through h6) in the article and generates a hierarchical outline that appears as a collapsible sidebar on the left or right side of the screen. Each heading is clickable—click any chapter to smoothly scroll to that section. As you read, the current section is highlighted in the sidebar, so you always know where you are in the article. A reading progress indicator shows how much of the article you've completed. Estimated reading time is shown for each chapter, and the total article reading time is displayed. Keyboard shortcuts (J for next chapter, K for previous chapter) let you navigate without touching your mouse. Your last read position is saved so you can pick up where you left off.

WHERE IT RUNS

This script runs on every website (matching all URLs), detecting headings across the entire web. It works on blog posts, documentation pages, news articles, tutorials, and any long-form content with headings. The script automatically adapts to each page and handles both static and dynamically loaded content.

HOW TO USE

After installing through the BotGentz extension, simply navigate to any long-form article with headings. The chapter navigation sidebar appears automatically on the side of the page. Use the configuration panel to customize your experience: toggle the navigation on or off, choose the sidebar position (left or right), enable or disable auto-collapse on scroll, show or hide the progress indicator, show or hide reading time estimates, enable or disable keyboard shortcuts (J/K), and toggle current section highlighting. The panel displays real-time statistics including the number of sections, article word count, and total reading time. Use the "Refresh Navigation" button to rebuild the outline, or "Toggle Collapse" to hide/show the sidebar.

HEADING HIERARCHY DETECTION WITH SCROLL-BASED ACTIVE SECTION TRACKING

This script implements a heading extraction engine that scans the DOM for all heading tags and builds a hierarchical outline based on heading levels (h1-h6). The engine calculates the vertical position of each heading relative to the viewport and tracks scroll position to determine which section is currently visible. The active section detection uses a threshold-based algorithm that identifies the heading closest to the top of the viewport, updating the sidebar highlight in real-time. The progress indicator calculates scroll percentage based on document height and viewport position. Chapter reading times are estimated using word count and average reading speed (200 WPM). The persistence system uses GM_setValue to store the last viewed chapter index, enabling session restoration.

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 navigation visibility, position, auto-collapse, progress display, reading time display, keyboard shortcuts, and highlighting—are persisted across sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. The script runs on all websites and reads page content to detect headings. It does not capture, store, or transmit any personal information. All data is stored locally in your browser using GM_setValue and never transmitted to external servers. The script detects headings on the page and may not work correctly on pages with non-standard heading structures or dynamic content that loads after the initial scan. Keyboard shortcuts may conflict with other site-specific shortcuts. This tool is provided for convenience and informational purposes only.