# bookokrat

> Terminal EPUB/PDF/DJVU reader with Vim-style keybindings, split layout, and SyncTeX support for LaTeX workflows

Stars: 1.3k · Categories: Productivity

- Repository: https://github.com/bugzmanov/bookokrat
- Website: https://bugzmanov.github.io/bookokrat/index.html
- Page: https://www.trmn.sh/tools/bookokrat

## Install

- Homebrew: `brew install bookokrat`
- AUR: `yay -S bookokrat-bin`
- Cargo: `cargo install bookokrat`

## Overview

Bookokrat is a terminal user interface (TUI) application for reading EPUB, PDF, and DJVU documents. It features a split-pane layout with a library and table of contents on the left side and the document reader on the right. The tool uses Vim-style keybindings and normal mode navigation for document control.

The application includes advanced PDF and DJVU rendering capabilities through the Kitty SHM image transfer protocol in supported terminals like Kitty, Ghostty, iTerm2, and WezTerm. It provides search functionality, bookmark management, jump list history, reading statistics, and inline comments with persistent storage that can be exported to Markdown. Users can customize themes, adjust margins, and enable zen mode for distraction-free reading.

A notable feature is bidirectional SyncTeX integration for LaTeX workflows. Users can compile LaTeX documents with synctex enabled and navigate between PDF output and source files through Ctrl+click or the `gd` command. The tool supports forward search from editors like VimTeX, allowing seamless jumping from LaTeX source to corresponding PDF locations. Configuration allows custom editor integration through Unix socket communication.

### Installation

```bash
# via Homebrew
brew install bookokrat
```

```bash
# via AUR
yay -S bookokrat-bin
```

```bash
# via Cargo
cargo install bookokrat
```

![Bookokrat terminal reader interface](https://media.trmn.sh/cached/262061dd223417f3282ca186b385cbeea7c6d6fa71a3b1e9afc76068f4dcef2f.mp4)

## Alternatives

- [dstask](https://www.trmn.sh/tools/dstask.md): Terminal-based TODO manager with git-based sync and markdown notes per task (1.2k stars)
- [basalt](https://www.trmn.sh/tools/basalt.md): Terminal user interface (TUI) for managing Obsidian vaults and notes from the command line (Rust, 1.4k stars)
- [fend](https://www.trmn.sh/tools/fend.md): Arbitrary-precision calculator with unit conversions, complex numbers, and D&D dice rolls (1.1k stars)
- [clipse](https://www.trmn.sh/tools/clipse.md): Configurable clipboard manager with TUI interface for Linux, macOS, and Unix systems supporting text and image history. (1.1k stars)
- [tz](https://www.trmn.sh/tools/tz.md): Interactive TUI tool for displaying and comparing times across multiple time zones simultaneously (Go, 903 stars)

---

Canonical: https://www.trmn.sh/tools/bookokrat