bookokrat

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

# via Homebrew
brew install bookokrat

# via AUR
yay -S bookokrat-bin

# via Cargo
cargo install bookokrat