# Install bookokrat with Homebrew

Terminal EPUB Book Reader. Version 0.3.12 via Homebrew; verified 2026-06-06.

## Install

```sh
sudo av install brew:bookokrat
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bookokrat
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:bookokrat
- **Package manager:** Homebrew
- **Version:** 0.3.12
- **Source summary:** Terminal EPUB Book Reader
- **Homepage:** <https://bugzmanov.github.io/bookokrat/index.html>
- **Repository:** <https://github.com/bugzmanov/bookokrat>
- **Last updated:** 2026-06-06T20:41:53Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- bookokrat (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.3.12
## Project history and usage

Bookokrat is a terminal ebook reader for EPUB and PDF, with a keyboard-heavy TUI, library discovery, reading progress, bookmarks, search, annotations, and PDF rendering features.

### Project history

The Git history begins in March 2025 with a basic EPUB reader TUI. The README later presents Bookokrat as a feature-rich terminal reader rather than a minimal pager, including Calibre library detection, table-of-contents navigation, PDF support, annotations, SyncTeX support, and Vim-style controls.

### Adoption history

Bookokrat is a young package with Homebrew packaging in the input metadata and an upstream GitHub Pages documentation site. Its adoption is likely among terminal-first readers, developers reading technical PDFs, and users who want ebook navigation without leaving a console workflow.

### How it is used

The documented interface emphasizes keyboard operation: library and reader panes, chapter navigation, search, marks, comments, theme selection, reading history, and PDF controls. Configuration is stored under the user's Bookokrat config directory with separate files for settings and keybindings.

### Why package nerds care

Bookokrat is notable as part of the modern terminal-app revival: it packages an experience that used to be GUI-only, but with rich TUI conventions and configuration files. For package indexes, it is a reminder that terminal productivity tools now include media-like workflows such as ebooks and PDFs.

### Timeline

- 2025-03-27: Initial commit for a basic EPUB reader with TUI.
- 2025-10-28: v0.1.0 tag appears.
- 2025-12-13: v0.2.0 tag appears.
- 2026-03-07: v0.3.7 tag appears.
- 2026-06-06: v0.3.12 tag appears.
- 2026-06-25: Recent repository commits show ongoing tweaks after v0.3.12.

### Related projects

- Calibre is related through the documented library detection feature.
- EPUB, PDF, and DjVu are related document formats in the package tags and documentation.
- VimTeX is related through the documented SyncTeX/editor integration workflow.

### Sources

- current_curation.config-file-location
- <https://bugzmanov.github.io/bookokrat/index.html>
- <https://github.com/bugzmanov/bookokrat/blob/main/readme.txt>
- <https://github.com/bugzmanov/bookokrat/releases>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for bookokrat. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/bookokrat/config.yaml, ~/.config/bookokrat/keybindings.toml
- Windows: %APPDATA%\bookokrat\config.yaml

## Combined YAML source

View the package source record on GitHub. [combined/bookokrat.yml](https://github.com/mxcl/pkgdb/blob/main/combined/bookokrat.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph