ranger
669aabf5f2
The WPM slider's maximum value now adapts to the active reading mode: - Word mode: 1500 WPM ceiling (human single-word recognition limit) - Sentence / Paragraph modes: 3000 WPM ceiling Rationale: in chunk modes, "WPM" controls auto-advance timing across larger display units. A 20-word sentence at 3000 WPM still gets ~400 ms of display time — well within visual-recognition comfort and suitable for skim-pass reading of already-familiar material. Switching back to Word mode auto-clamps the current value down to 1500 to prevent accidentally-illegible word-mode playback. The `+` keyboard shortcut now respects the mode-specific ceiling instead of being hardcoded to 1500.
◈ Ranger Reader
A lightweight RSVP reader for academic papers and long-form text — single HTML file, no install, no subscription, no cloud, runs offline in any browser.
Built to handle the volume of reading required by a research thesis without paying the $120/year for SwiftRead or similar tools. Released here so others can do the same.
What it does
Three reading modes for the same text:
| Mode | What it does | Best for |
|---|---|---|
Word (key 1) |
Classic RSVP — one word at a time at a chosen WPM, with ORP (Optimal Recognition Point) focal-character colouring | Fast skim, the "I'm reading at 4× normal speed" experience |
Sentence (key 2) |
One full sentence at a time, auto-advancing based on word count | Comprehension-grade reading of methods and results sections |
Paragraph (key 3) |
One paragraph at a time, longer display | Preview / postview stages, skim for quotes |
How to use
- Open
ranger-reader.htmlin any modern browser (double-click works) - Paste text into the textarea at the bottom, or drag any
.txtfile onto the page - Press the spacebar or click ▶ Play
- Tap
1/2/3to switch between Word / Sentence / Paragraph modes - Slide WPM up or down to taste (default 500, range 200–1500)
Text, WPM, mode, and reading position all auto-save in your browser — close the tab, reopen tomorrow, resume where you stopped.
Keyboard shortcuts
| Key | Action |
|---|---|
Space |
Play / pause |
← / → |
Skip back / forward (10 in Word mode, 1 in chunk modes) |
1 / 2 / 3 |
Switch to Word / Sentence / Paragraph mode |
+ / − |
Adjust WPM by 50 |
R |
Reset to start |
Converting PDF papers
The reader takes plain text. To convert academic PDFs:
# macOS / Linux — install poppler-utils first (e.g. brew install poppler)
pdftotext input.pdf output.txt
Then drag the .txt file onto the reader page.
What it doesn't do (yet)
- A built-in file library — paste or drag, one paper at a time
- Per-paper bookmarks — single position memory
- Background sound / brown noise — planned for v1.2
- Browser extension packaging — planned for v2.0
- Multi-language ORP heuristics — currently tuned for English
Why RSVP works
RSVP (Rapid Serial Visual Presentation) shows words sequentially at a fixed location, eliminating the eye saccades that normal reading requires. For many readers — particularly dyslexic readers — this:
- Reduces visual-tracking effort
- Eliminates letter-reversal confusion (words don't sit next to each other)
- Enforces consistent pacing (no getting lost in a paragraph)
- Allows comfortable reading at speeds well above normal saccading limits
Brain comprehension is the real ceiling, not eye movement. RSVP lets you read closer to that ceiling.
Caveats
For academic citation work, use Sentence or Word mode in combination with the source PDF — RSVP is excellent for prose but cannot render tables, figures, or equations. The published recommended workflow:
- First pass via Sprint / RSVP at high WPM to get the paper's shape
- Second pass in the source PDF for the Methods, Results, tables and figures
- Capture exact quotes with page numbers from the PDF, not the RSVP stream
The abstract is an advert — don't cite it. Read the Introduction, Methods, Results, and Discussion. The meat is in the middle.
License
GPL v2 or later. See LICENSE.
Acknowledgements
Built as a study tool during an MSc thesis on accessibility-focused authentication research. Released as free software because reading subscriptions are a tax on poor researchers and accessibility tools should not be paywalled.