for terminal workflows

TERMINAL
EPUB
READER

// FULL-FEATURED EPUB RENDERING • IMAGES • TABLES & CODE BLOCKS • VIM KEYBINDINGS • MOUSE SUPPORT
INLINE ANNOTATIONS • LOCAL & GLOBAL SEARCH

READ TECHNICAL BOOKS WITHOUT LEAVING YOUR TERMINAL

Install
Bookokrat help screen
Reading view
Book content
Chapter navigation

Built for technical reading

Everything you need to read and research technical books in your terminal

Complete EPUB/HTML rendering

Proper table layouts, syntax-highlighted code blocks, bold/italic text, blockquotes, lists, and MathML equations. Uses html5ever parser—reads like the author intended.

Annotate & research

Press 'a' on any selection to attach timestamped notes. Full-text search across books. Copy chapters or selections. Your reading workspace in the terminal.

Vim keybindings + mouse support

Full vim motions (j/k, gg/G, /, Ctrl+o/i) for keyboard users. Comprehensive mouse support for everyone else. Use whichever you prefer—or both.

Never lose your place

Automatic bookmarks per book. Reading history popup (Space+h). Chapter statistics and progress tracking. Jump list remembers your navigation path.

installation

Get Started

Install with Cargo (Rust's package manager). Get it at rustup.rs

cargo install bookokrat
// Quick Start
1. Navigate to a directory with EPUB files
2. Run bookokrat
3. Use j/k to navigate, Enter to open a book, ? for help

See it in action

Watch bookokrat handle real technical content

Bookokrat demo showing EPUB reading in terminal

How does it compare?

Terminal EPUB readers compared side-by-side

Feature ↓ / Reader → Bookokrat bk epr epy baca Lue
EPUB support
Inline images in terminal ✗* ✗* (ANSI)
MathML rendering
Table of contents (basic)
Search (chapter & book) (incremental) (regex) (regex)
Bookmarks / resume
Highlights / notes
Text-to-speech (TTS)
Multi-format (beyond EPUB)
Library / history view
* epr/epy can open images via external viewer; not inline in the terminal.