Reading Speed Test

WHAT IT DOES

Reading Speed Test is a floating panel that helps you measure and improve your reading speed. Paste or type any text into the panel, click "Start Test" to begin a timed reading session, and read the text at your natural pace. When you click "Stop Test", the panel calculates your reading speed in words per minute (WPM), along with total time and word count. The panel also supports comprehension tracking—you can add multiple‑choice or fill‑in questions to test your understanding of the text, and the panel records your comprehension score alongside your WPM. All test results (WPM, comprehension score, date, and time) are automatically saved to a history log, allowing you to track your progress over time. You can insert your current WPM result directly into any editable field on the page (input, textarea, or contenteditable) with one click, or copy all results and history to your clipboard. The panel also includes adjustable font size and dark/light mode for comfortable reading in any environment. Perfect for students preparing for exams, professionals improving their reading efficiency, or anyone curious about their reading speed.

WHERE IT RUNS

The panel overlays any website that loads the BotGentz extension—whether you're on an article page, a document editor, a learning platform, or any other web page. It works on all modern Chromium‑based browsers (Chrome, Edge, Brave, Arc) and Firefox. The script injects a self‑contained UI element that does not interfere with the host page's layout, styles, or JavaScript execution. It runs client‑side only, with no external API calls or cloud dependencies.

HOW TO USE

After installing the free BotGentz extension, visit any page and click the extension icon to activate the panel. The first time you use Reading Speed Test, it will appear as a draggable widget near the bottom‑right corner of your viewport. To take a reading speed test:

- Paste or type the text you want to read into the "Text to Read" input area.

- Adjust the font size using the dropdown and toggle dark mode if desired.

- Click "Start Test"—the panel will clear the reading area and begin tracking time.

- Read the text at your natural pace. When you finish, click "Stop Test".

- The panel instantly displays your WPM, total reading time, and word count.

- Your result is automatically saved to the history log.

- To test comprehension, you can manually add questions in the text area before starting—the panel will display them after the test.

To use your results:

- Click "Insert WPM Result" to paste your WPM into the focused editable field.

- Click "Copy All Results" to copy your current results and recent history to your clipboard.

- Use "Clear History" or "Reset All Settings" to manage your saved data.

The panel remembers your font size preference and dark/light mode setting across sessions, and your test history is preserved for long‑term progress tracking.

PRECISION TIMING ENGINE WITH WORD‑COUNT TOKENIZATION

Unlike simple speed calculators that rely on manual timing or rough estimates, this panel uses a precision timing engine built on JavaScript's high‑resolution timestamps (performance.now() internally) to measure elapsed time with millisecond accuracy. When the user clicks "Start Test", the engine captures a timestamp and immediately locks the text input to prevent accidental changes during the test. On "Stop Test", it captures the end timestamp and computes the exact elapsed time in milliseconds. Simultaneously, a word‑count tokenizer processes the source text using a whitespace‑delimited tokenization strategy that handles multiple spaces, newlines, and punctuation properly—the same tokenizer used to display the word count during setup. The WPM formula is: (wordCount / elapsedMilliseconds) * 60000, yielding the words‑per‑minute value. The engine also includes a debouncing guard that prevents double‑clicks from restarting or stopping the test incorrectly. The history module stores each result as a structured object with timestamp, WPM, word count, elapsed time, and optional comprehension score, using a FIFO queue that caps at 20 entries to keep storage efficient while preserving trend data for progress comparison.

THE PANEL

- Drag: Click and hold the panel's header bar to move it anywhere on the screen.

- Per‑site position: The panel stores its last position separately for each domain (e.g., different positions for Medium vs. Google Docs) using the browser's localStorage, keyed by hostname.

- Snap: When dragged near any edge of the viewport, the panel snaps to that edge with a 16px margin for a clean, docked feel.

- Collapse: Click the "−" button in the header to collapse the panel to a compact title bar, preserving all current values. Click "+" to expand it back.

- Resize: Drag the bottom‑right corner handle to resize the panel from 280px to 600px wide and 200px to 500px tall; the layout adapts responsively.

- Escape: Press the Escape key while the panel is focused to close it entirely (you can reopen it from the extension toolbar).

PLEASE NOTE

This script requires the free BotGentz extension to run—it is not a standalone bookmarklet or user script. Websites frequently update their DOM structures and security policies; while we strive to keep the panel functional across thousands of sites, occasional updates may be needed. The calculator performs all operations entirely in your browser—no data is sent to any server, and no cookies or tracking identifiers are used. Your reading texts, test results, and history remain private to your local session and are persisted only via GM_setValue (the extension's local storage) for convenience, not shared across devices or sessions. Comprehension questions are currently user‑defined and must be added manually to the text area; auto‑generation from text is a planned enhancement. Reading speed can vary based on text complexity and familiarity; use consistent test materials for accurate progress tracking.