deephaven-plugin-speed-reader

A deephaven.ui element that reads text to you one word at a time — rapid serial visual presentation (RSVP), the technique behind Spritz-style readers.

Because the words appear in a fixed position, your eyes never move between them. The highlighted pivot letter marks the optimal recognition point, the spot the eye naturally focuses on, and it stays put no matter how long the word is.

Install

pip install deephaven-plugin-speed-reader

Restart the Deephaven server so it picks up the plugin.

Usage

speed_reader takes a string and returns an element. There is no hook to call and nothing to mount.

from deephaven import ui

from deephaven_plugin_speed_reader import speed_reader


@ui.component
def my_panel():
    return speed_reader("The quick brown fox jumps over the lazy dog", default_wpm=400)


my_reader = my_panel()

Options

text is the single positional argument; everything else is optional.

Speed is clamped to 60–1200 wpm.

Controlled vs uncontrolled speed

Follows the same convention as other deephaven.ui inputs.

Uncontrolled — the component owns the speed. Simplest, and the slider works on its own:

speed_reader(passage, default_wpm=350)

Controlled — Python owns the speed, so anything can drive it. Pass wpm and update it from on_wpm_change, or the slider will appear stuck:

@ui.component
def my_panel():
    wpm, set_wpm = ui.use_state(300)
    return ui.flex(
        speed_reader(passage, wpm=wpm, on_wpm_change=set_wpm),
        ui.button("Speed read", on_press=lambda _e: set_wpm(800)),
        direction="column",
    )

Reading text from a table

speed_reader takes a plain string, so any source works — including a table cell:

@ui.component
def article_reader():
    body, set_body = ui.use_state("Click a row to start reading.")
    return ui.flex(
        ui.table(articles, on_row_press=lambda row: set_body(row["Body"]["value"])),
        speed_reader(body, default_wpm=400),
    )

New text resets the reader to the first word.

See examples/ for complete, runnable panels.

Contributing

See AGENTS.md for the dev loop, project layout, and how to build, test, and lint.

License

Apache-2.0