ranger
5e0ef5adf1
Single-file HTML RSVP reader for academic papers and long-form text. Released free / GPL v2+ as a replacement for subscription-based RSVP readers (SwiftRead, etc.) that cost ~$120/year for the same core functionality. v1.1.0 ships with three reading modes: - Word: classic RSVP with ORP focal-character coloring - Sentence: chunked reading, auto-advancing on word-count timing - Paragraph: skim mode Other features: WPM slider 200-1500, drag-drop .txt loading, localStorage persistence (text + WPM + mode + position), keyboard shortcuts, dark-mode WP-tone palette, sentence splitter that handles common academic abbreviations (Mr./Dr./e.g./i.e./et al./ Vol./Fig./decimals). Single self-contained HTML file. No install, no dependencies, no network calls. Runs in any modern browser, fully offline.
3.6 KiB
◈ 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.