Terminal ebook reader · open source

Read books where your hands already are.

Readio is a keyboard-first TUI for EPUB, PDF, Markdown, and plain text. It brings focused reading, real progress, and optional local read-aloud into the terminal — without another media player to manage.

Install readio Explore the source

macOS · Linux · Windows builds from source

readio · The Shape of Attention

 readio   The Shape of Attention     ch 1/4

 ❙ Thought for 1.3s

 ● Read attention.md  L1-9  ·  0.3s
   # One  Attention in eighty columns
   The first time I noticed that attention
   had a shape, I was watching a cursor…

╭────────────────────────────────────────────╮
│❯ enter to keep reading; / opens commands   │
╰────────────────────────────────────────────╯
  ⠼ Read-aloud  ·  0:06  ·  64 tok

Bring your books

A serious reader for ordinary files.

EPUB

Parsed into chapters, paragraphs, positions, and searchable text.

PDF

Parsed into chapters, paragraphs, positions, and searchable text.

Markdown

Parsed into chapters, paragraphs, positions, and searchable text.

Plain text

Parsed into chapters, paragraphs, positions, and searchable text.

Made for deep reading

The terminal is the interface.

Three reading modes

Manual, Auto, and Read-aloud stay explicit, interruptible, and in sync.

Local voices

Use a local TTS model or your own command. No bundled model or cloud account is required.

Search that lands

Full-text search counts every match and jumps to the exact sentence in your book.

Positions that survive

Bookmarks and progress are stored as content offsets, so reorganising a book does not lose your place.

Start in one command

Your next chapter is already on disk.

curl -fsSL https://raw.githubusercontent.com/hrhrng/readio/main/apps/tui/scripts/install.sh | sh

The installer downloads a verified release for macOS or Linux. Windows users can build the same pure-Rust binary from source.