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
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.
Get Started
Prerequisites
Bookokrat requires a C compiler/linker to build dependencies. Install the build tools for your platform:
sudo apt update && sudo apt install build-essential
sudo dnf install gcc make
xcode-select --install
Install Bookokrat
Install with Cargo (Rust's package manager). Get it at rustup.rs
cargo install bookokrat
2. Run
bookokrat3. Use
j/k to navigate, Enter to open a book, ? for help
This means you don't have a C compiler installed. Install the build tools for your platform (see Prerequisites above), then try again.
See it in action
Watch bookokrat handle real technical content
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 | ✓ | ✗ | ✓ | ✓ | ✓ | ✗ |