Readwyn 0.1.0

How to find text in an ebook on a Mac

Press ⌘F in the Readwyn reader, or click “Find” in the top bar, and start typing. Results come in as you type: a list under the field shows every match with its chapter, its page, and the words around it. Click a match to go there.

The find bar

The bar opens in the middle of the top bar. It has the field, the position (“62 of 284”), up and down buttons (“Previous match” and “Next match”), and “Done”.

The find bar with the query heart, 1 of 14, and the list of matches under it, each with Book II · Chapter XX, its page, and its context
Click a row to jump to that match

The list opens with a count, for example “41 matches · in any case, also inside words”. Each row gives the chapter, the page, and the match with about 40 characters either side. If the reader hasn’t laid that page out yet, the row shows a percentage instead.

On the page itself every match is tinted, and the current one is also underlined in your accent colour.

Moving between matches

  • Click a row, or press Return in the field. The first Return goes to the first match at or after your place, and each one after that moves on.
  • ⌘G, or the down button in the bar, goes to the next match. After the last one, it wraps round to the first.
  • ⇧⌘G, or the up button, goes back one.
  • Escape closes the list, and a second Escape (or “Done”) closes the bar.

What counts as a match

A query matches anywhere in the text, inside words too, and ignores case. “heart” finds “hearth” and “Sweetheart”, “Heart” finds “heart”, and “sss” finds “potsss”.

Accents, spaces and punctuation have to match as you typed them. “ville” won’t find “villé”, and “gave up” won’t find “gave—up”.

Matches never overlap, so “ss” occurs twice in “ssss”, and none runs across a chapter break. If there’s nothing to find, the field says “No matches”.

Getting back to your page

Searching never loses your place. As soon as you jump to a match, the footer offers “Back to p. 196” (with your own page number) and “Stay here”, and a mark on the progress track shows where you were. The first button, or ⌘[, takes you back. “Stay here” makes the current page your new place. Turning the pages back to your place settles it too.

Until you decide, Readwyn keeps your saved place where it was, so if you close the book mid-search, it reopens where you were reading. Both buttons stay in the footer after you close the find bar.

From a selection

Select some text and the selection popover has a Find in the book button, which opens the bar with your selection already filled in. Right-clicking a selection or a highlight gives the same option, as Find “…” in the book with your text in the quotes.

How fast it is

Readwyn’s target is 100 ms or less from the search to the first frame that shows the result. In the latest measurement across four test libraries of 10 to 10,000 books, the slowest of three runs of each English query took between 11 and 33 ms. One query missed the target: a Tamil word took 269 ms in the 10-book library, against 45 to 46 ms in the others.

The scan of the text on its own is quicker still. The largest book in the Readwyn test corpus is a Portuguese dictionary of 11.85 million characters, and a search for “e” in it finds 941,208 matches in 16 ms. In Ulysses, every query takes 2 ms or less. The search reads the text that the reader already holds, and it keeps no copy of the book.

One book at a time

Find only searches the open book; Readwyn doesn’t search the text of every book in a library at once. To find a book by its title, author or series, use the library search. Your highlights and notes from every book have a search of their own in the Notebook, “Search highlights and notes”.