EPUB + HTML PDF MODE IMAGES MATHML

READ PDF/EPUB BOOKS IN THE TERMINAL

Bookokrat renders EPUB and PDF content with real layouts, images, and math. Built for readers who live in the terminal.

Install Watch demos
Bookokrat help screen
Bookokrat EPUB reading view
Bookokrat theme selection
Bookokrat zen mode with Catppuccin Mocha theme
Bookokrat PDF reader with Rosepine Moon theme
Bookokrat reading view

Demos

EPUB and PDF, captured in the terminal.

EPUB / HTML demo

Tables, code blocks, MathML, and images rendered inline.

PDF demo

Page/scroll modes, outline, search, and annotations.

Features that matter

Everything you expect, nothing you do not.

EPUB + HTML

Proper layout: tables, lists, images, and code blocks.

PDF modes

Page and scroll views with TOC and fast navigation.

MathML

Readable equations for math-heavy books.

Annotations

Attach notes, export Markdown, and track history.

Vim + Mouse

Keyboard-first or mouse-friendly, your choice.

Graphics

Kitty, Sixel, iTerm2, and Unicode image backends.

Reading workflow

Full-text search, jump list, bookmarks, and annotation export make Bookokrat a research tool.

PDF rendering requires a graphics-capable terminal. If images render, PDF pages will too. EPUB works everywhere.

Install

Pick a path and start reading.

Homebrew (macOS) brew install bookokrat
  • Prereqs: Homebrew installed.
  • PDF support is enabled by default.
Linux binary GitHub Releases (musl)
  • Prereqs: curl and tar.
  • Download and extract:
  • curl -LO https://github.com/bugzmanov/bookokrat/releases/latest/download/bookokrat-v0.3.1-x86_64-unknown-linux-musl.tar.gz
  • tar -xzf bookokrat-v0.3.1-x86_64-unknown-linux-musl.tar.gz
  • Install to your PATH:
  • sudo mv bookokrat /usr/local/bin/
Arch Linux AUR (bookokrat-bin)
  • Install with your AUR helper:
  • yay -S bookokrat-bin or paru -S bookokrat-bin.
Cargo (all platforms) cargo install bookokrat
  • Prereqs: Rust toolchain + C compiler/linker.
  • Linux (Debian/Ubuntu): sudo apt install build-essential.
  • Linux (Fedora/RHEL): sudo dnf install gcc make.
  • macOS: xcode-select --install.
  • Windows: Visual Studio Build Tools with C++ workload.
  • PDF builds on Linux: pkg-config, libfontconfig1-dev, clang, libclang-dev.
  • Without PDF: cargo install bookokrat --no-default-features.

FAQ

Short answers for common setup questions.

Is PDF support enabled by default?

Yes. To build without PDF support use --no-default-features.

What do I need to build from source?

A C compiler and standard build tools. For PDF builds on Linux, install pkg-config, libfontconfig1-dev, and libclang-dev.

Does it work on Windows?

Yes, via Cargo. Install the Visual Studio Build Tools with C++ workload.